Skip to content
Crossmart Docs

Gemini CLI

Checked on 2026-11-06 against geminicli.com: MCP servers, configuration and skills. An API key header is supported.

Google moved unpaid-tier and Google One users from Gemini CLI to Antigravity CLI on 2026-06-18; this page covers Gemini CLI.

Connect

Section titled “Connect”

Create a key (how), then add this to ~/.gemini/settings.json (user) or .gemini/settings.json (project):

{
  "mcpServers": {
    "crossmart": {
      "httpUrl": "https://mcp.crossmart.io/mcp",
      "headers": { "x-api-key": "${CROSSMART_API_KEY}" }
    }
  }
}

Use httpUrl (Streamable HTTP), not url (SSE). Gemini CLI expands ${VAR} in settings, so export CROSSMART_API_KEY in your shell and the file holds no secret.

The CLI form writes the key itself into the file:

Terminal window
gemini mcp add --transport http --header "x-api-key: $CROSSMART_API_KEY" -s user \
  crossmart https://mcp.crossmart.io/mcp

Check

Section titled “Check”
Terminal window
gemini mcp list

In a session, /mcp shows crossmart and its tools.

Install the skill

Section titled “Install the skill”
Terminal window
gemini skills install https://github.com/crossmart-io/crossmart.git --path skills/crossmart --scope user

Or copy the skills/crossmart folder to ~/.gemini/skills/ or ~/.agents/skills/. /skills list confirms it. The repository is private for now; see the Crossmart skill.