bank

The bank-mcp server provides a read-only MCP interface to your bank accounts, enabling an AI assistant to query balances, transactions, and spending breakdowns through natural language. It connects to real banking providers via the Model Context Protocol, making it compatible with any MCP client (Claude Code, Claude Desktop, Cursor, Windsurf, Gemini CLI, Codex CLI, and more). The server exposes a set of tools for common banking tasks and can be run with a mock provider for testing before connecting real accounts. To integrate with your MCP client, use the standard MCP stdio transport and point the client to the bank server as shown in the client setup guides.

Prerequisites:

• Node.js >= 18 installed on your machine
• npm (comes with Node.js) or pnpm/yarn if you prefer

Installation & setup steps:

1. Ensure Node.js is available: node -v npm -v

2. Initialize the bank-mcp server setup (this also provides a mock/demo mode): npx @bank-mcp/server init

3. Run the server (default usage via npx): npx @bank-mcp/server

4. Optional: run in mock mode to test without real bank credentials: npx @bank-mcp/server --mock

5. Connect to the server from your MCP client following the client-specific instructions in the README (Claude Code, Cursor, Windsurf, Gemini CLI, Codex CLI, Zed, etc.). For example, Claude Code users can add: claude mcp add bank -- npx @bank-mcp/server

Prerequisites recap:

• A supported MCP client (Claude Code, Cursor, Windsurf, Gemini, Codex, etc.)
• Access to the internet to fetch the MCP server via npx or a local installation
• Optional: real bank credentials if you plan to connect to actual bank providers

Tips and common considerations:

• The server is read-only by design for security and safety; no funds transfers or modifications are possible through MCP.
• If you haven’t connected real banks yet, use --mock to generate deterministic sample accounts and transactions for testing.
• You can access multiple providers (Plaid, Teller, Enable Banking, Tink, Mock) via the setup wizard during initialization.
• When configuring clients, you can reuse the standard npx @bank-mcp/server command across many tools; many clients import the same command in their mcp.json or equivalent config.
• Environment variables can be used to customize behavior or select providers during setup; consult the provider guides in the README for details on environment choices.