Connect ChatMaxima MCP with Gemini

Overview

This guide shows how to connect ChatMaxima MCP with Gemini so Gemini can build chatbots, WhatsApp templates and WhatsApp Flows in your workspace. The supported path is the Gemini CLI, Google's open-source command-line agent, which can connect to remote MCP servers. You add ChatMaxima to the CLI configuration, authenticate once with OAuth, and Gemini can then use ChatMaxima tools.

ChatMaxima MCP is a remote, streamable HTTP server secured with OAuth 2.1, so you never store an API key in your configuration file.

Prerequisites

Before you begin, ensure you have:

• A ChatMaxima account with a role that can use the builder, templates or Flows.
• The Gemini CLI installed and signed in to your Google account.
• The MCP URL: https://chatmaxima.com/mcp

Step 1: Open your Gemini CLI settings

The Gemini CLI reads MCP servers from a settings.json file. You can use the global file or a project-level file.

• Global: ~/.gemini/settings.json
• Project: .gemini/settings.json in your working directory

Open the file you want to use. Create it if it does not exist.

Step 2: Add ChatMaxima as an MCP server

Add a mcpServers entry that points to the ChatMaxima URL using the httpUrl key for streamable HTTP:

{
  "mcpServers": {
    "chatmaxima": {
      "httpUrl": "https://chatmaxima.com/mcp"
    }
  }
}

If your settings.json already has other keys, add the mcpServers block alongside them rather than replacing the file.

Note: Use httpUrl for ChatMaxima. It is a streamable HTTP MCP server, not a local command, so there is no command or args to set.

Step 3: Authenticate with OAuth

1. Start the Gemini CLI.
2. Trigger the ChatMaxima sign-in:

/mcp auth chatmaxima

3. Your browser opens the ChatMaxima consent screen. Sign in to ChatMaxima.
4. Choose the workspace you want Gemini to access if you belong to more than one team.
5. Review the access and click Approve.

The CLI stores the connection so you do not need to sign in again for future sessions.

Step 4: Verify the connection

List the MCP servers and their tools to confirm ChatMaxima is connected:

/mcp list

You should see the chatmaxima server with its available tools. The tools shown depend on your role in the selected workspace.

Step 5: Build something

Ask Gemini to build in plain language, for example:

Using ChatMaxima, create a customer support chatbot for an online store.
Greet the visitor, offer buttons for Orders, Returns and Talk to a human,
and route each choice to the right reply. Run a test at the end.

Gemini calls ChatMaxima tools to create the bot, add and connect blocks, organize the canvas and run a test. Open the bot in your ChatMaxima dashboard to review and publish it.

Manage or revoke access

• In the Gemini CLI: remove the chatmaxima entry from mcpServers in settings.json to stop using it.
• In ChatMaxima: open Settings, then Connected Apps, and revoke the connection. It stops working immediately.

Troubleshooting

/mcp list does not show ChatMaxima

1. Confirm the mcpServers block uses httpUrl and the exact URL https://chatmaxima.com/mcp.
2. Confirm the JSON is valid, with no trailing commas.
3. Restart the Gemini CLI so it reloads settings.json.

Authentication does not complete

1. Run /mcp auth chatmaxima again and finish the browser sign-in.
2. Allow your browser to open the ChatMaxima consent window.

No tools appear after connecting

1. Confirm your role in the selected workspace has builder, template or Flow access.
2. Re-run /mcp auth chatmaxima and select the correct workspace.

Next Steps

• Create a Chatbot with MCP →
• Connect with Claude →
• Connect with Codex / ChatGPT →