---
title: "Email for Gemini CLI"
description: "Give Gemini CLI a real inbox over MCP. It reads, replies and sends from the addresses you approve, for as long as you allow."
url: "https://openemail.uk/agents/gemini-cli"
---

Gemini CLI + OpenEmail

# Give Gemini CLI an inbox. On terms you set.

Gemini CLI reads, replies and sends from the addresses you approve, for as long as you allow. Add one server, then sign in once in your browser.

[Open mail](https://openemail.uk/mail/inbox) [Get Started](https://openemail.uk/signup.md)[Read the MCP guide](https://openemail.uk/docs/mcp/connect.md)

Add it to Gemini CLI`{ "mcpServers": { "openemail": { "httpUrl": "https://api.openemail.uk/mcp" } } }`

Add it to ~/.gemini/settings.json, then run /mcp auth openemail in Gemini CLI.

## Three steps. Then it works on its own.

1. 01
   
   Add the server
   
   Add it to ~/.gemini/settings.json, then run /mcp auth openemail in Gemini CLI.
2. 02
   
   Sign in and approve
   
   Gemini CLI sends you to your browser to sign in. Pick the workspace, the addresses it may reach and for how long.
3. 03
   
   Ask for something
   
   Start with a prompt below. It calls the tools it needs, and nothing outside what you approved.

[Build email into an app with Gemini CLI](https://openemail.uk/developers/gemini-cli.md)

## What Gemini CLI can do with it. Through one connection.

`$ openemail temp new`

[Agent features](https://openemail.uk/agents/features.md)

## Ask Gemini CLI. In plain words.

Each prompt shows the tools it is likely to call.

- Summarise my unread mail at support@acme.com and draft replies. Don't send them yet.
  
  - listThreads
  - getThread
  - createDraft
- Answer Ada's refund question in her thread, then file it under refunds.
  
  - getThread
  - replyToEmail
  - modifyLabels
- Find the invoice Jonas sent last month and sum up the thread.
  
  - listThreads
  - getThreadSummary
- Add Noor Haddad to my contacts and to the Beta audience.
  
  - createContact
  - addContactToAudience

## You approve it. Like any other app.

When the client signs in, you pick the workspace, what it may do, which addresses it reaches and for how long. Account → Connected apps changes or removes it later.

- **Your role is the ceiling**
  An app never holds a permission you lack, and when your role loses one, the app loses it on its next call.
- **Some things are never granted**
  No app can create or rotate API keys, open billing or manage the workspace, whatever you tick.
- **Risky changes wait for you**
  Adding a webhook, writing a rule, changing roles or removing a domain needs your verification code, or a 60-minute allowance you switch on for that app.

[How an approval is scoped](https://openemail.uk/docs/mcp/scope.md)

## Asked first. Answered plainly.

## Works with the rest, too. Same server, any client.

- [Claude Code Full Claude Code setup](https://openemail.uk/agents/claude-code.md)
- [Codex Full Codex setup](https://openemail.uk/agents/codex.md)
- [Cursor Full Cursor setup](https://openemail.uk/agents/cursor.md)
- [GitHub Copilot Full GitHub Copilot setup](https://openemail.uk/agents/github-copilot.md)
- [Windsurf Full Windsurf setup](https://openemail.uk/agents/windsurf.md)
- [Claude Desktop Full Claude Desktop setup](https://openemail.uk/agents/claude-desktop.md)

[See everything agents can do](https://openemail.uk/agents.md)

## Give it an address. Watch it work.

MCP, the API and the command line come with every plan, the free one included. Connect a client and approve exactly what it reaches.

[Open mail](https://openemail.uk/mail/inbox) [Get Started](https://openemail.uk/signup.md)[Read the MCP guide](https://openemail.uk/docs/mcp/overview.md)

`claude mcp add --transport http openemail https://api.openemail.uk/mcp`