AI client docs

Connect AllSquare to AI clients

Connect ChatGPT, Claude, Gemini CLI, and other MCP clients to AllSquare. They can read your groups and create expenses only with your approval.

Most modern AI clients connect to AllSquare through a single MCP URL.

https://allsquare.app/api/mcp

Permissions

Only approve AI clients you trust. Write actions should be treated like sending a message or submitting a form: review what the client is about to do before you approve the tool call.

AllSquare uses two permission scopes:

  • allsquare:read lets the client view your groups, group members, recent expenses, and balances.
  • allsquare:write lets the client create one-time and recurring expenses.

When a client connects, AllSquare will show the scopes it requested. Most MCP clients request both. Some configurations request only read access.

MCP Endpoint

Add https://allsquare.app/api/mcp to clients that support remote MCP over Streamable HTTP, then complete the browser authorization flow when the client starts the connection.

The server supports OAuth discovery, dynamic client registration, and bearer-token authentication. If your client asks for scopes, request allsquare:read and allsquare:write.

AllSquare does not provide a local stdio MCP server or other MCP transport.

ChatGPT

The recommended ChatGPT setup is the official AllSquare GPT. You can also use MCP if your ChatGPT workspace supports custom MCP connectors. In both cases, ChatGPT will ask you to sign in and approve access before it can read groups, check balances, or create expenses.

Option 1: official AllSquare GPT

Open the AllSquare GPT, sign in, and approve the requested AllSquare permissions.

Open AllSquare GPT

Option 2: MCP connector

If your ChatGPT workspace supports custom MCP connectors, add AllSquare using this MCP endpoint:

https://allsquare.app/api/mcp

Example prompts: "Show my AllSquare groups," "What do I owe in my Apartment group?," and "Add $42.10 for groceries yesterday, split with Alex."

Claude and Claude Desktop

Claude web

  1. Open Claude settings and go to Connectors.
  2. Choose the option to add a custom connector.
  3. Use https://allsquare.app/api/mcp as the remote MCP server URL.
  4. Follow the browser authorization flow and approve the AllSquare scopes you want Claude to use.
  5. Start a new Claude chat and ask "Show my AllSquare groups." to verify the connector.

Claude Desktop

Claude Desktop's connector flow is similar. Add a custom remote MCP connector in the app, use the AllSquare MCP URL, then complete the browser authorization flow.

You do not need to edit claude_desktop_config.json for AllSquare.

Claude Code

Add AllSquare as a user-scoped remote HTTP MCP server so it is available across your Claude Code projects:

claude mcp add --transport http --scope user allsquare https://allsquare.app/api/mcp

To add it only for the current project, omit the scope flag:

claude mcp add --transport http allsquare https://allsquare.app/api/mcp
  1. Open Claude Code and run /mcp.
  2. Select AllSquare, authenticate in the browser, and approve access.
  3. Run claude mcp list to confirm the server is configured.

After connecting, ask: "Show my AllSquare groups."

Gemini CLI

Gemini supports MCP through Gemini CLI. Add AllSquare as a user-scoped remote HTTP MCP server:

gemini mcp add --transport http --scope user allsquare https://allsquare.app/api/mcp
  1. Start Gemini CLI.
  2. When Gemini prompts for authentication, complete the browser flow. You can also run /mcp auth allsquare to start auth manually.
  3. Run /mcp inside Gemini CLI to confirm AllSquare is connected, or gemini mcp list from a shell to confirm it is configured.

After connecting, ask: "Show my AllSquare groups."

Disconnect an AI Client

  1. Sign in to AllSquare.
  2. Open Settings and find Connected AI clients.
  3. Select Disconnect next to the client you want to revoke.

Disconnecting revokes the client's AllSquare tokens. You can also clear the saved connection inside the AI client if it stores a local copy of the connector configuration.

Troubleshooting

  • If authentication fails or the client says the token expired, disconnect AllSquare in Settings, then connect again from the AI client.
  • If the client does not show AllSquare tools after connecting, restart the client or reload its MCP/connectors list.
  • If you are on a team or workspace account, an admin policy may block custom MCP connectors. Ask your workspace admin to allow the AllSquare MCP URL.
Connect AllSquare to AI clients