Bookie MCP Server
by yuens1002io.github.yuens1002/bookiev0.8.5
Double-entry bookkeeping MCP server — import bank CSVs, categorize, reconcile, tax reports.
context tax
queued
security
queued
cold start
queued
freshness
Active22d ago
Install Bookie MCP server
Install in Claude Code
claude mcp add bookie -e BOOKIE_DB_URL='<bookie-db-url>' -e BOOKIE_DB_DIRECT_URL='<bookie-db-direct-url>' -e BOOKIE_API_KEY='<bookie-api-key>' -- npx -y bookie-mcpInstall in Cursor
{
"mcpServers": {
"bookie": {
"command": "npx",
"args": [
"-y",
"bookie-mcp"
],
"env": {
"BOOKIE_DB_URL": "<bookie-db-url>",
"BOOKIE_DB_DIRECT_URL": "<bookie-db-direct-url>",
"BOOKIE_API_KEY": "<bookie-api-key>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).
Install in Claude Desktop
{
"mcpServers": {
"bookie": {
"command": "npx",
"args": [
"-y",
"bookie-mcp"
],
"env": {
"BOOKIE_DB_URL": "<bookie-db-url>",
"BOOKIE_DB_DIRECT_URL": "<bookie-db-direct-url>",
"BOOKIE_API_KEY": "<bookie-api-key>"
}
}
}
}Settings → Developer → Edit Config (claude_desktop_config.json), then restart.
Install in VS Code
{
"servers": {
"bookie": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"bookie-mcp"
],
"env": {
"BOOKIE_DB_URL": "<bookie-db-url>",
"BOOKIE_DB_DIRECT_URL": "<bookie-db-direct-url>",
"BOOKIE_API_KEY": "<bookie-api-key>"
}
}
}
}Add to .vscode/mcp.json in your workspace.
Install in Windsurf
{
"mcpServers": {
"bookie": {
"command": "npx",
"args": [
"-y",
"bookie-mcp"
],
"env": {
"BOOKIE_DB_URL": "<bookie-db-url>",
"BOOKIE_DB_DIRECT_URL": "<bookie-db-direct-url>",
"BOOKIE_API_KEY": "<bookie-api-key>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json.
Configuration
| Variable | Required | Secret | Description |
|---|---|---|---|
| BOOKIE_DB_URL | yes | yes | Neon pooled Postgres connection string — the ledger database |
| BOOKIE_DB_DIRECT_URL | yes | yes | Neon direct (non-pooled) Postgres connection string, used for schema push |
| BOOKIE_API_KEY | yes | yes | Static Bearer token for authenticating requests (printed by `npm run setup`) |
Freshness
Active — last maintenance signal 22d ago. The newest of the signals below sets the band.
Last commit (default branch)
2026-09-18 · 22d ago · GitHub
Latest release
2026-09-18 · 22d ago · GitHub · v0.8.16
Package published
no data · npm/PyPI
Registry entry updated
2026-07-03 · 3mo ago · official registry · v0.8.5
FAQ
›How do I install the Bookie MCP server in Claude Code?
Run: claude mcp add bookie -e BOOKIE_DB_URL='<bookie-db-url>' -e BOOKIE_DB_DIRECT_URL='<bookie-db-direct-url>' -e BOOKIE_API_KEY='<bookie-api-key>' -- npx -y bookie-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.
›Does Bookie require an API key?
Yes. It expects BOOKIE_DB_URL, BOOKIE_DB_DIRECT_URL, BOOKIE_API_KEY, of which 3 are secrets.
›Can I use Bookie as a remote (hosted) MCP server?
No hosted endpoint is published; it runs locally over stdio.
›Is Bookie in the official MCP registry?
Yes, as io.github.yuens1002/bookie.