Skip to content

Connect Gemini CLI

Use Rampsend from Gemini CLI

The Gemini CLI has MCP support built in and is free and open source. Add the Rampsend endpoint and Gemini can send email, check deliveries and read your stats from the terminal.

Run in your terminal

Terminal
gemini mcp add --transport http rampsend https://app.rampsend.com/api/mcp

Set it up

  1. 1

    Add the server with a key

    Add --scope user to write the global config rather than the project one.

    Terminal
    gemini mcp add --transport http \  -H "Authorization: Bearer rs_live_…" \  rampsend https://app.rampsend.com/api/mcp
  2. 2

    Or add it for sign-in

    Leave the header off, then run /mcp auth rampsend inside the CLI and finish in the browser.

    Terminal
    gemini mcp add --transport http rampsend https://app.rampsend.com/api/mcp
  3. 3

    Check it

    Start gemini and run /mcp list. rampsend should show Ready, with its tools listed.

    In a session
    /mcp list

The config

File: ~/.gemini/settings.json

JSON
{  "mcpServers": {    "rampsend": {      "url": "https://app.rampsend.com/api/mcp",      "type": "http",      "headers": {        "Authorization": "Bearer $RAMPSEND_API_KEY"      },      "timeout": 30000,      "trust": false    }  }}

Or <project>/.gemini/settings.json. url with "type": "http" pins Streamable HTTP — this is what gemini mcp add writes.

Check it works

Ask “How many Rampsend credits do I have left?”. A number back means you are connected. That call only reads your account, so testing costs nothing.

What trips people up

  • Use url. The older httpUrl field still works but is deprecated, and gemini mcp add never writes it — so a config from the command and one copied from an old guide will not match.
  • timeout is in milliseconds in this file (30000 = 30 seconds).
  • Sign-in needs a browser on the machine. On a headless box or over SSH, use an API key instead.
  • Leave trust as false unless you want every tool call — sending included — to skip its confirmation prompt.
  • mcpServers stays a top-level key. A project .gemini/settings.json overrides the global one for a server of the same name; /mcp refresh reloads after an edit.

Try asking

  • “Show my sending stats for the last 14 days.”
  • “Send a plain-text test from hello@acme.com to me@acme.com.”
  • “Which DNS records does acme.com still need?”
  • “How many Rampsend credits do I have left?”

Using something else?