Connect BankSync to Notion

Connect BankSync MCP server to Notion's AI agents for accessing bank data within your Notion workspace.

Prerequisites

A BankSync account with at least one connected bank
An API key with all permission scopes (created from Workspace → Developers)

Configuration

Add the BankSync server to your Notion MCP configuration, replacing the placeholder with your API key:

MCP config (JSON)

{
  "mcpServers": {
    "banksync": {
      "url": "https://mcp.banksync.io",
      "headers": {
        "X-API-Key": "bsk_your_api_key_here"
      }
    }
  }
}

Where it goes: claude_desktop_config.json (Claude Desktop) · .cursor/mcp.json (Cursor) · context_servers (Zed)

Notion's own MCP server (npm package) configured alongside BankSync in claude_desktop_config.json

{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": ["-y", "@notionhq/notion-mcp-server"],
      "env": {
        "NOTION_TOKEN": "ntn_your_notion_token_here"
      }
    },
    "banksync": {
      "type": "http",
      "url": "https://mcp.banksync.io",
      "headers": {
        "X-API-Key": "bsk_your_api_key_here"
      }
    }
  }
}

Tip. How it works: Notion acts as an MCP server. You connect it to your AI client (Claude Desktop, Cursor, etc.) alongside BankSync. The AI client can then read and write Notion pages while also querying your bank data through BankSync.

Tip. Step 1: Get a Notion Integration Token by going to notion.so/profile/integrations and creating a new internal integration to obtain your NOTION_TOKEN.

Tip. The same dual-server config pattern works in Cursor (.cursor/mcp.json), Zed (context_servers), and any other MCP client that supports multiple servers.

Server URL. BankSync’s MCP server is at https://mcp.banksync.io over Streamable HTTP, authenticated with your X-API-Key. If Notion can’t reach a remote server, use the local bridge npx -y @banksync/mcp with BANKSYNC_API_KEY set.

Verify your connection

Restart your client and try these prompts to confirm the connection works:

“List my workspaces”

“What banks do I have connected?”

“What’s my checking account balance?”

Troubleshooting

“No tools available” or the MCP server is not listed

Make sure you restarted your AI client after editing the config file.
Verify the JSON/YAML is valid (no trailing commas, correct brackets).
Check the URL is exactly https://mcp.banksync.io.

“Authentication failed” or “Invalid API key”

Confirm the key starts with bsk_ and has not been revoked.
Ensure the key is passed in the X-API-Key header.
Check for stray whitespace or newlines around the key value.

Connection timeout or the client lacks remote HTTP support

The server uses Streamable HTTP. Allow outbound HTTPS to mcp.banksync.io.
If your client only supports local servers, use the npm bridge: npx -y @banksync/mcp.

Tools are listed but return errors

Verify your API key has the required scopes — for full access, select all scopes when creating the key.
Make sure you have at least one bank connected in the BankSync app.
Check that you are passing the correct workspace ID when prompted.

Debugging with MCP Inspector

Use the MCP Inspector to test the connection independently of your AI client.
Run: npx @modelcontextprotocol/inspector --url https://mcp.banksync.io--header "X-API-Key: bsk_your_key"
If the Inspector connects but your client does not, the issue is your client configuration.

Frequently asked questions

Does Notion support MCP servers?

Yes. Notion supports custom MCP servers through its custom AI agents feature. This requires a Notion Business or Enterprise plan.

What Notion plan do I need for custom MCP servers?

Custom MCP servers in Notion require a Business or Enterprise plan. The feature is not available on Free or Plus plans.

Can I choose which BankSync tools are available in Notion?

Yes. After connecting BankSync as an MCP server, you can toggle individual tools on or off to control what capabilities your Notion AI agent has access to.

← All clients