sentfromai-mcp

MCP server for SentFromAI — email infrastructure for AI agents.

Gives any MCP-capable agent (Claude Code, Claude Desktop, Cursor, VS Code, Gemini CLI, Codex, OpenClaw, or your own MCP host) email as native tools: create inboxes, send, reply, forward, search, read threads, manage drafts, custom domains, webhooks, and allow/block rules — 21 tools, each a thin wrapper over the SentFromAI REST API. Every tool carries MCP annotations (read-only / write / send / delete) so hosts can group them and confirm the irreversible ones.

You need a SentFromAI API key (sf_live_…) from the console. Free plan: 5 inboxes, 5,000 emails/month, no card.

Let your agent install it

Paste this into your agent (Claude Code, OpenClaw, Gemini CLI, any MCP-capable agent):

Set up SentFromAI email for yourself: fetch https://docs.sentfrom.ai/agent-install.md
and follow it. Ask me for the API key when you need it.

Install

Claude Code

As a plugin (asks for the key when you enable it, and adds a skill that teaches Claude email etiquette):

claude plugin marketplace add sentfromai/sentfromai-mcp
claude plugin install sentfromai@sentfromai

Or as a plain MCP server:

claude mcp add sentfromai --env SENTFROMAI_API_KEY=sf_live_… -- npx -y sentfromai-mcp

Claude Desktop, Cursor, Windsurf, Cline, any JSON-config host

{
  "mcpServers": {
    "sentfromai": {
      "command": "npx",
      "args": ["-y", "sentfromai-mcp"],
      "env": { "SENTFROMAI_API_KEY": "sf_live_…" }
    }
  }
}

Cursor one-click (then paste your key into the generated config):

VS Code

code --add-mcp '{"name":"sentfromai","command":"npx","args":["-y","sentfromai-mcp"],"env":{"SENTFROMAI_API_KEY":"sf_live_…"}}'

Gemini CLI

gemini extensions install https://github.com/sentfromai/sentfromai-mcp

Gemini asks for the API key on install and keeps it in your keychain.

Codex CLI

codex mcp add sentfromai --env SENTFROMAI_API_KEY=sf_live_… -- npx -y sentfromai-mcp

OpenClaw

openclaw mcp add sentfromai --command npx --arg -y --arg sentfromai-mcp --env SENTFROMAI_API_KEY=sf_live_…
openclaw skills install git:sentfromai/sentfromai-mcp

Full guide: docs.sentfrom.ai/frameworks/openclaw.

Hosted endpoint (no install)

The same 21 tools are served over Streamable HTTP at https://api.sentfrom.ai/mcp for hosts that only speak remote MCP (claude.ai connectors, ChatGPT apps, Meta Muse, Cursor remote servers, MCP Inspector). Authenticate with Authorization: Bearer sf_live_… (an x-api-key header also works), or let OAuth-capable hosts sign you in: the endpoint publishes RFC 9728 resource metadata pointing at SentFromAI's authorization server.

claude mcp add --transport http sentfromai https://api.sentfrom.ai/mcp --header "Authorization: Bearer sf_live_…"

Tools

Area	Tools	Annotation
Inboxes	create_inbox · list_inboxes · delete_inbox	write · read · delete
Messages	send_message · reply_to_message · forward_message	send (irreversible, open world)
	get_message · search_messages	read
Threads	list_threads · get_thread	read
Drafts	create_draft · send_draft · list_drafts	write · send · read
Domains	add_domain · get_domain	write · read
Webhooks	create_webhook · list_webhooks · delete_webhook	write · read · delete
Allow/block	add_address_rule · list_address_rules · delete_address_rule	write · read · delete

Replies thread correctly (In-Reply-To/References set automatically), search supports keyword, semantic, and hybrid modes, and sends respect the same idempotency and suppression rules as the REST API. API failures come back as tool results with isError and the HTTP status, so the model can read a 401 (bad key) or 402 (plan limit) and tell you instead of retrying.

Configuration

Env var	Required	Default
SENTFROMAI_API_KEY	yes	—
SENTFROMAI_BASE_URL	no	https://api.sentfrom.ai

Programmatic use

The tools are exported so you can embed them in your own MCP host or transport:

import { createServer, TOOLS, callTool, createApi } from 'sentfromai-mcp'

const server = createServer({ apiKey: process.env.SENTFROMAI_API_KEY })
await server.connect(yourTransport)

Privacy

This server keeps no state and stores nothing locally. Every tool call is one HTTPS request to api.sentfrom.ai authenticated with your API key. SentFromAI's privacy policy: https://sentfrom.ai/privacy · terms: https://sentfrom.ai/terms.

Docs

• MCP guide
• API reference
• SentFromAI for agents