Converts PDF bank statements into JSON, Excel or CSV with balance validation through the MainBook API, without connecting to bank accounts.
Setup
Choose your client, copy the config, then fill in any required environment variables.
Local
claude mcp add mainbook --env MAINBOOK_API_KEY='<MAINBOOK_API_KEY>' -- uvx mainbook-mcp~/.codex/config.toml
[mcp_servers.mainbook]
command = "uvx"
args = ["mainbook-mcp"]
env = { MAINBOOK_API_KEY = "<MAINBOOK_API_KEY>" }
# codex mcp add mainbook --env MAINBOOK_API_KEY='<MAINBOOK_API_KEY>' -- uvx mainbook-mcp~/.cursor/mcp.json
{
"mcpServers": {
"mainbook": {
"command": "uvx",
"args": [
"mainbook-mcp"
],
"env": {
"MAINBOOK_API_KEY": "<MAINBOOK_API_KEY>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"mainbook": {
"type": "stdio",
"command": "uvx",
"args": [
"mainbook-mcp"
],
"env": {
"MAINBOOK_API_KEY": "<MAINBOOK_API_KEY>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"mainbook": {
"command": "uvx",
"args": [
"mainbook-mcp"
],
"env": {
"MAINBOOK_API_KEY": "<MAINBOOK_API_KEY>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"mainbook": {
"command": "uvx",
"args": [
"mainbook-mcp"
],
"env": {
"MAINBOOK_API_KEY": "<MAINBOOK_API_KEY>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"mainbook": {
"command": "uvx",
"args": [
"mainbook-mcp"
],
"env": {
"MAINBOOK_API_KEY": "<MAINBOOK_API_KEY>"
}
}
}
}Remote
claude mcp add --transport http mainbook https://mcp.mainbook.ai/mcp~/.codex/config.toml
[mcp_servers.mainbook]
url = "https://mcp.mainbook.ai/mcp"
# codex mcp add mainbook --url https://mcp.mainbook.ai/mcp~/.cursor/mcp.json
{
"mcpServers": {
"mainbook": {
"url": "https://mcp.mainbook.ai/mcp"
}
}
}.vscode/mcp.json
{
"servers": {
"mainbook": {
"type": "http",
"url": "https://mcp.mainbook.ai/mcp"
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"mainbook": {
"httpUrl": "https://mcp.mainbook.ai/mcp"
}
}
}claude_desktop_config.json · Customize › Connectors › Add custom connector
{
"mcpServers": {
"mainbook": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.mainbook.ai/mcp"
]
}
}
}.trae/mcp.json
{
"mcpServers": {
"mainbook": {
"url": "https://mcp.mainbook.ai/mcp"
}
}
}Environment variables
MAINBOOK_API_KEY
Replace the placeholders with your own credentials and keep them out of version control.