Metadata-Version: 2.4
Name: email2chat-mcp
Version: 0.1.0
Summary: MCP server for Email2Chat — connect Claude Desktop and AI agents to your monitored email inbox
Project-URL: Homepage, https://email2chat.com
Project-URL: Documentation, https://email2chat.com/developers
Project-URL: Repository, https://github.com/csbgroup/email2chat-mcp
Project-URL: Bug Tracker, https://github.com/csbgroup/email2chat-mcp/issues
License: MIT
Keywords: ai,claude,email,gmail,mcp,outlook,telegram
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Communications :: Email
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27.0
Requires-Dist: mcp>=1.0.0
Description-Content-Type: text/markdown

# email2chat-mcp

MCP server for [Email2Chat](https://email2chat.com) — connect Claude Desktop and AI agents to your monitored Gmail and Outlook inboxes.

## What it does

Gives Claude (and any MCP-compatible AI agent) access to your email inbox:

- **Read recent emails** — subject, sender, AI summary, classification label
- **Search emails** — by keyword, sender, or AI label (Urgent, Promotional, etc.)
- **Get full email body** — fetch complete email content on demand
- **Check monitoring status** — see which inboxes are active
- **Mark as read / Archive** — Outlook/Office 365 (Gmail write support coming after CASA verification)

## Requirements

1. An [Email2Chat](https://email2chat.com) account with at least one monitored inbox
2. An API key from your Email2Chat dashboard → **API Keys** section

## Installation

### Claude Desktop (recommended)

Add to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "email2chat": {
      "command": "uvx",
      "args": ["email2chat-mcp"],
      "env": {
        "EMAIL2CHAT_API_KEY": "em2c_your_key_here"
      }
    }
  }
}
```

Config file location:
- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
- **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`

### With pip

```bash
pip install email2chat-mcp
EMAIL2CHAT_API_KEY=em2c_your_key email2chat-mcp
```

## Environment variables

| Variable | Required | Default | Description |
|----------|----------|---------|-------------|
| `EMAIL2CHAT_API_KEY` | Yes | — | Your API key from the dashboard |
| `EMAIL2CHAT_API_URL` | No | `https://email2chat.com/api/v1` | Override for self-hosted instances |

## Available tools

| Tool | Description |
|------|-------------|
| `get_recent_emails` | Get latest emails with AI summaries |
| `search_emails` | Search by keyword, sender, or label |
| `get_email_body` | Fetch full body of a specific email |
| `get_monitoring_status` | Check which inboxes are active |
| `mark_email_read` | Mark email as read (Outlook only for now) |
| `archive_email` | Archive email (Outlook only for now) |

## Example prompts

Once connected, ask Claude:

- *"What urgent emails did I get today?"*
- *"Summarize my last 5 emails from invoices@company.com"*
- *"Are any of my inboxes down?"*
- *"Find all newsletters from this week and archive them"*

## API docs

Full REST API documentation: [email2chat.com/developers](https://email2chat.com/developers)

## License

MIT
