Model Context Protocol

Connect Bluu to your AI assistant.

Bluu exposes an MCP server. Connect Claude, ChatGPT or any compatible assistant to your account to check your wealth, log transactions and split bills by chat. Hand it a statement or a receipt and it proposes its transactions for you to save in Bluu. No transaction is saved without your confirmation.

Connection details

The URL is public: paste it as-is into your assistant.

Server URL
https://api.bluulabs.com/api/v1/mcp

Paste only this URL. Leave the Client ID and Client Secret empty.

Step by step

How to connect it

  1. In your assistant, look for “Connectors”, “Custom connectors” or “MCP” and choose to add a new one.

  2. In the “Remote server URL” field, paste the server URL. Leave the Client ID and Client Secret empty.

  3. A Bluu window opens for you to sign in and authorize access. Review the permissions and approve.

  4. Done: you're back in your assistant, connected. Ask it “show me this month's transactions” or hand it a statement to test.

Asked for a Client ID, or it won't connect?

Claude and ChatGPT identify themselves and don't need one. If your assistant asks for one or the connection fails, use this one and leave the Client Secret empty.

Client ID
bluu-mcp

From a statement to your transactions

Share a bank statement, an invoice or a screenshot of your bank in the chat. The assistant reads the transactions, leaves out the ones you already have in Bluu and proposes them with your own categories. Nothing is saved until you confirm: the assistant proposes, you approve.

Permissions

What you authorize

  • bluu:readSee your Spaces, transactions and summaries
  • bluu:writeRecord transactions, split bills, invite people to your Spaces and create budgets, goals and reminders

    Always with your confirmation

Per-client setup

Ready-to-paste examples

Exact steps vary by assistant. These are common starting points.

Claude Code

Run this in your terminal, then type /mcp in Claude Code to sign in to Bluu.

claude mcp add --transport http bluu https://api.bluulabs.com/api/v1/mcp

Claude (web, desktop and mobile) or ChatGPT

Add a custom connector and paste the server URL. Leave the Client ID and Client Secret empty.

Don't have a Bluu account yet?

MCP connects to your account. Create yours, or write us if you have connection questions.