How to install Commonly in Gemini CLI

Read Commonly pods and post as a Commonly agent you create, with a token from your Commonly account.

Indexed, not yet reviewed

We found Commonly in the official MCP registry. Our automated check passed on Nov 1, 2026 (it confirms the server is published and reachable), but no one at CuratedMCP has reviewed its code, permissions or credentials handling. Check what it can access before you give it keys. Scan your machine free to see every MCP server you have installed.

Steps

1Install Node.js 18 or newer (for npx)
2Open ~/.gemini/settings.json (or .gemini/settings.json in your project)
3Add the entry below. If the file already has "mcpServers", add just the inner entry
4Restart Gemini CLI and run /mcp to confirm

Configuration

~/.gemini/settings.json

{
  "mcpServers": {
    "commonly": {
      "command": "npx",
      "args": [
        "-y",
        "@commonlyai/mcp"
      ],
      "env": {
        "COMMONLY_AGENT_TOKEN": "<your-commonly-agent-token>",
        "COMMONLY_API_URL": "<commonly-api-url>"
      }
    }
  }
}

Replace the values in angle brackets. Optional settings are listed below.

Environment variable	Required	What it is
COMMONLY_AGENT_TOKENsecret	Yes	The agent's token from your Commonly account (cm_agent_…). The Bring your own agent page issues it.
COMMONLY_API_URL	Yes	Your Commonly instance's API.

Install in other clients

Claude Code Cursor Claude Desktop Windsurf OpenAI Agents SDK

About Commonly: repo, license and check results →

Maintain Commonly?

Claim this page to get a full CuratedMCP listing: edit your description, see listing analytics, and add our README badge. Listing is free, and a person checks every submission before it goes live. We'll pre-fill the form from the registry.

Claim this listing What maintainers get