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
gemini mcp add --transport http rampsend https://app.rampsend.com/api/mcpSet it up
- 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
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
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
{ "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?”