# longbook MCP server

> Lets an AI client access and analyze your recurring commitments, subscriptions, and expenses to provide financial insights and suggest changes.

- Repository: https://github.com/MXmaster2s/longbook-code
- Page: https://hostedmcp.org/servers/mxmaster2s/mcp
- Transport: stdio, remote
- Stars: 0
- License: GPL-3.0
- Latest version: 1.50.0

## Install

### Claude Code

```sh
claude mcp add mcp -- npx -y @longbook/mcp
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@longbook/mcp"
      ]
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@longbook/mcp"
      ]
    }
  }
}
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@longbook/mcp"
      ]
    }
  }
}
```

### Codex (`~/.codex/config.toml`)

```toml
[mcp_servers.mcp]
command = "npx"
args = ["-y", "@longbook/mcp"]
```

### Gemini CLI (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@longbook/mcp"
      ]
    }
  }
}
```

## FAQ

### How can I connect the hosted server to my AI?

You can connect via OAuth in your browser by copying the connect prompt from the longbook app or website and pasting it into your AI client.

### Can the AI automatically edit my financial records?

No, the AI can only suggest changes which must be reviewed and approved in the app's Changes screen before they are applied.

### How do I use the local server version?

You can run the local server using npx by pointing it to your longbook folder with the --vault flag.

### What kind of files can the local server read?

The local server can read bank statements in PDF, .xlsx, and CSV formats, as well as reports generated by longbook.