# mcp

Connect an agent to SentFromAI email tools for inboxes, message search, threads, and sending. An API key is required.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: sentfromai
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/sentfromai/sentfromai-mcp
- Updated: 2026-10-08
- HTML: https://affpapa.org/en/nevibecode/mcp/sentfromai-mcp

## What it does

The server gives an agent tools for SentFromAI inboxes, messages, threads, drafts, domains, webhooks, and address rules. It can search by keywords or meaning, read conversations, and send or forward messages. Replies are linked to the original thread automatically.

Each tool call reaches the SentFromAI REST API. The server keeps no local state or data. Run it with `npx` or connect to the hosted HTTP endpoint. You need a `SENTFROMAI_API_KEY`; requests will fail without a valid key. API errors reach the agent with their HTTP status, including invalid-key and plan-limit errors.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://api.sentfrom.ai/mcp`
- Environment variables: `SENTFROMAI_API_KEY`, `SENTFROMAI_BASE_URL` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI**
```bash
claude mcp add --env SENTFROMAI_API_KEY=<SENTFROMAI_API_KEY> --env SENTFROMAI_BASE_URL=<SENTFROMAI_BASE_URL> --transport stdio sentfromai-mcp -- npx -y sentfromai-mcp
```
Replace <…> with your own values

2. **Platform CLI: remote server**
```bash
claude mcp add --transport http sentfromai-mcp https://api.sentfrom.ai/mcp
```

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add sentfromai-mcp --url https://api.sentfrom.ai/mcp
```

2. **Platform CLI**
```bash
codex mcp add sentfromai-mcp --env SENTFROMAI_API_KEY=<SENTFROMAI_API_KEY> --env SENTFROMAI_BASE_URL=<SENTFROMAI_BASE_URL> -- npx -y sentfromai-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "sentfromai-mcp": {
            "url": "https://api.sentfrom.ai/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "sentfromai-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "sentfromai-mcp"
            ],
            "env": {
                "SENTFROMAI_API_KEY": "<SENTFROMAI_API_KEY>",
                "SENTFROMAI_BASE_URL": "<SENTFROMAI_BASE_URL>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "sentfromai-mcp": {
            "type": "http",
            "url": "https://api.sentfrom.ai/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "sentfromai-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "sentfromai-mcp"
            ],
            "env": {
                "SENTFROMAI_API_KEY": "<SENTFROMAI_API_KEY>",
                "SENTFROMAI_BASE_URL": "<SENTFROMAI_BASE_URL>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http sentfromai-mcp https://api.sentfrom.ai/mcp
```

2. **Platform CLI**
```bash
gemini mcp add -e SENTFROMAI_API_KEY=<SENTFROMAI_API_KEY> -e SENTFROMAI_BASE_URL=<SENTFROMAI_BASE_URL> sentfromai-mcp npx -y sentfromai-mcp
```
Replace <…> with your own values

## When to use it
- create an inbox for an agent
- find messages by topic or meaning
- read a thread and reply in context
- draft and send an email
- manage webhooks or address rules

## Example prompts
- Create a separate inbox for this project.
- Find emails about the payment failure and summarize the thread.
- Reply to the latest message in this conversation, keeping its subject.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 392262
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33989
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81163
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119231
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47577
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43902

## Other versions with the same name
- [mcp · kubeshark](https://affpapa.org/en/nevibecode/mcp/kubeshark-mcp.md) — ★ 12110
- [mcp · butterbase-ai](https://affpapa.org/en/nevibecode/mcp/butterbase-ai-mcp.md) — ★ 3031
- [mcp · medplum](https://affpapa.org/en/nevibecode/mcp/mcp.md) — ★ 2766
- [mcp · sceneview](https://affpapa.org/en/nevibecode/mcp/sceneview-mcp.md) — ★ 1349
- [mcp · buoy-gg](https://affpapa.org/en/nevibecode/mcp/buoy-gg-mcp.md) — ★ 691

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md