Docs
Open app

AI assistants

Connect AllSquare to AI clients

Connect ChatGPT, Claude, Gemini CLI, and other MCP clients to AllSquare. Once you approve access, they can read your data and add, change, or settle expenses and manage groups. Using a terminal or a coding agent? The AllSquare CLI is another option. See all docs.

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

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, expense history, recurring expenses, settlements, spend summaries, and balances across all your groups.
  • allsquare:write lets the client create, edit, and delete one-time expenses, manage recurring expenses (create, edit, pause, resume, delete), settle up, create groups, and add or invite members by email.

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 connect AllSquare's MCP server in Developer mode, if your account or workspace allows it. 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 server in Developer mode

  1. In ChatGPT, open Settings → Security and login and turn on Developer mode.
  2. Go to chatgpt.com/plugins and select the plus button to add a connection.
  3. Enter the AllSquare MCP URL below, then sign in and approve access.
MCP URL
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. Go to Customize → Connectors.
  2. Select the plus button, then Add 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.

On Team and Enterprise plans, an owner first adds the connector under Organization settings → Connectors; members then connect it from Customize → Connectors.

Claude Desktop

Claude Desktop uses the same connectors: add AllSquare under Customize → Connectors with 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:

Terminal
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:

Terminal
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."

Prefer a command-line tool the agent can run directly? Install the AllSquare CLI and have the agent start with allsquare agent-guide --json.

Gemini CLI

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

Terminal
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."

Prefer a command-line tool the agent can run directly? Install the AllSquare CLI and have the agent start with allsquare agent-guide --json.

Disconnect an AI client

  1. Sign in to AllSquare.
  2. Open Settings and find Connected apps.
  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.