Gemini CLI

Connect Shipchart to Gemini CLI to manage your portfolio from Google's AI terminal agent.

1. Generate an API token

Select read and write abilities. Copy the token immediately.

2. Add the MCP server

Open your Gemini CLI settings file at ~/.gemini/settings.json (or the project-level .gemini/settings.json) and add the Shipchart server:

{
  "mcpServers": {
    "shipchart": {
      "httpUrl": "https://shipchart.app/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN_HERE"
      }
    }
  }
}

3. Restart Gemini CLI

Restart Gemini CLI to pick up the new configuration. The Shipchart tools should now be available.

4. Test it

In your terminal, ask Gemini:

"What's my current monthly revenue (across all projects)?"

Gemini will use the Shipchart tools to fetch your portfolio data and respond.

Troubleshooting

Tools not appearing

Check that your settings.json is valid JSON and that the token is correct. Restart Gemini CLI after making changes.

Connection errors

Make sure the key is httpUrl (not url). Gemini CLI uses httpUrl for HTTP-based MCP servers.

For a full list of available tools, prompts, and resources, see the MCP Overview.