Content
# SendCore MCP Server
**Give your AI agent an email inbox.**
Let Claude, ChatGPT, Cursor, Copilot, and any MCP-compatible AI send and receive emails — through natural language.
No API wrappers. No webhook plumbing. One config line.
```bash
npx sendcore-mcp
```
Then tell your AI: *"Read my inbox for the verification code from Acme Corp"* or *"Send a welcome email to the new user"*.
## Quick Start
```bash
# Get a free API key
# https://usesendcore.com → API Keys → Create MCP Key
# Run the server
export SENDCORE_API_KEY=sc_mcp_your_key_here
npx sendcore-mcp
```
### Claude Desktop
```json
{
"mcpServers": {
"sendcore": {
"command": "npx",
"args": ["-y", "sendcore-mcp"],
"env": {
"SENDCORE_API_KEY": "sc_mcp_your_key_here"
}
}
}
}
```
### ChatGPT (OAuth)
Available in the ChatGPT MCP directory — connects via OAuth, no API key needed.
## What Can Your AI Agent Do?
### Send transactional emails
`send_email` — From your verified domain, to one or many recipients. Supports HTML, plain text, CC, BCC, tags.
### Read incoming emails
`read_emails` — Read emails received by any agent inbox. Optionally search by meaning.
`extract_otp` — Find the latest verification code / OTP from a specific sender.
`get_email` — View a single email with full body and attachments.
### Manage agent inboxes
`create_inbox` / `list_inboxes` / `delete_inbox` — Each inbox gets its own email address and optional webhook.
`send_as_agent` — Reply as the inbox, thread-aware.
### View email delivery
`email_logs` — Check delivery status, opens, clicks, bounces.
### Automate workflows
`list_workflows` / `create_workflow` / `activate_workflow` — Create automation rules triggered by contacts, emails, schedules, or webhooks.
## Recipes
- [AI Customer Support Agent](recipes/ai-support-agent.md) — Read, triage, and reply to customer emails
- [Auto OTP Verification](recipes/auto-otp-verification.md) — Automatically extract verification codes from incoming mail
- [Daily Email Digest](recipes/email-summarizer.md) — AI summarizes your inbox each morning
- [Newsletter Curator](recipes/newsletter-agent.md) — AI researches and sends curated newsletters
- [Slack Email Bridge](recipes/slack-email-bridge.md) — Forward important emails to Slack
- [CI/CD Notifications](recipes/github-actions-email.md) — Automated deployment emails
- [Feedback Collector](recipes/customer-feedback-agent.md) — Send and collect customer feedback automatically
## Architecture
```
Your AI (Claude, ChatGPT, etc.)
│
│ MCP Protocol (stdio or HTTP)
▼
SendCore MCP Server ←→ SendCore API
│
┌──────┼──────┐
▼ ▼ ▼
SMTP relay DO OpenAI
(delivery) (infra) (embeddings)
```
The server runs as a lightweight Node.js process. In stdio mode it talks directly to your AI host. In gateway mode it runs as an HTTP server with per-user auth — the same endpoint that powers the ChatGPT directory.
## Why SendCore?
- **AI-native** — Built for LLMs, not legacy SMTP
- **Agent inboxes** — Inbound email addresses your AI can read and reply from
- **Semantic search** — Find emails by meaning, not just keywords
- **OTP extraction** — Auto-detect verification codes in incoming mail
- **Thread support** — AI maintains conversation context
- **Custom domains** — Send from your own domain
## Development
```bash
git clone https://github.com/usesendcore/sendcore-mcp
cd sendcore-mcp
npm install
npm run dev # stdio mode
npm run gateway # HTTP mode
```
## License
MIT
