README.md
Give Claude, Cursor, or any MCP client a real email address. Free.
@keyid/agent-kit
Give Claude, Cursor, or any MCP client a real email address. Free. No signup.
27 email tools via Model Context Protocol (MCP): send, receive, reply, search inbox, manage contacts, set auto-reply, schedule delivery — everything an AI agent needs to handle email autonomously.
Powered by KeyID.ai — free email infrastructure for AI agents. No human registration, no API keys to manage, no cost.
Install
npm install @keyid/agent-kit
# or
yarn add @keyid/agent-kit
Usage
With Claude Desktop
Add to claude_desktop_config.json:
{
"mcpServers": {
"keyid": {
"command": "npx",
"args": ["@keyid/agent-kit"],
"env": {
"KEYID_PUBLIC_KEY": "...hex...",
"KEYID_PRIVATE_KEY": "...hex..."
}
}
}
}
With any MCP client
# Run directly
npx @keyid/agent-kit
# Or with existing keypair
KEYID_PUBLIC_KEY=abc123 KEYID_PRIVATE_KEY=def456 npx @keyid/agent-kit
Environment Variables
| Variable | Description | Default |
|---|---|---|
KEYID_BASE_URL |
API base URL | https://keyid.ai |
KEYID_PUBLIC_KEY |
Ed25519 public key (hex) | Auto-generated |
KEYID_PRIVATE_KEY |
Ed25519 private key (hex) | Auto-generated |
Tools (27)
Identity & Auth
| Tool | Description |
|---|---|
keyid_provision |
Register agent, get email address |
keyid_get_email |
Get current active email |
Messages
| Tool | Description |
|---|---|
keyid_get_inbox |
Fetch inbox (with search, filtering) |
keyid_send |
Send email (scheduled, display name, HTML) |
keyid_reply |
Reply to a message |
keyid_forward |
Forward a message |
keyid_update_message |
Update read/starred status |
keyid_get_unread_count |
Count unread messages |
Threads & Drafts
| Tool | Description |
|---|---|
keyid_list_threads |
List conversation threads |
keyid_get_thread |
Get thread with messages |
keyid_create_draft |
Create a draft |
keyid_send_draft |
Send a draft |
Settings
| Tool | Description |
|---|---|
keyid_get_auto_reply |
Get auto-reply settings |
keyid_set_auto_reply |
Configure vacation responder |
keyid_get_signature |
Get email signature |
keyid_set_signature |
Set email signature |
keyid_get_forwarding |
Get forwarding settings |
keyid_set_forwarding |
Configure forwarding |
Contacts
| Tool | Description |
|---|---|
keyid_list_contacts |
List saved contacts |
keyid_create_contact |
Create a contact |
keyid_delete_contact |
Delete a contact |
Webhooks
| Tool | Description |
|---|---|
keyid_list_webhooks |
List webhooks |
keyid_create_webhook |
Create webhook |
keyid_get_webhook_deliveries |
Delivery history |
Lists & Metrics
| Tool | Description |
|---|---|
keyid_manage_list |
Add/remove from allow/blocklist |
keyid_get_metrics |
Query usage metrics |
Example Conversation
User: Check my email
Agent: [calls keyid_get_inbox]
You have 3 new messages:
1. alice@company.com — "Q1 Report" (2 hours ago)
2. bob@partner.org — "Meeting tomorrow" (5 hours ago)
3. noreply@service.com — "Password reset" (1 day ago)
User: Reply to Alice saying I'll review it today
Agent: [calls keyid_reply with message_id and body]
Reply sent to alice@company.com.
Protocol
Uses MCP JSON-RPC over stdio (protocol version 2024-11-05). Compatible with Claude Desktop, Cursor, and any MCP client.
License
MIT
Tools (26)
keyid_provisionRegister agent and get an email addresskeyid_get_emailGet current active emailkeyid_get_inboxFetch inbox with search and filteringkeyid_sendSend email with support for scheduling and HTMLkeyid_replyReply to a messagekeyid_forwardForward a messagekeyid_update_messageUpdate read or starred status of a messagekeyid_get_unread_countCount unread messageskeyid_list_threadsList conversation threadskeyid_get_threadGet thread with messageskeyid_create_draftCreate a draftkeyid_send_draftSend a draftkeyid_get_auto_replyGet auto-reply settingskeyid_set_auto_replyConfigure vacation responderkeyid_get_signatureGet email signaturekeyid_set_signatureSet email signaturekeyid_get_forwardingGet forwarding settingskeyid_set_forwardingConfigure forwardingkeyid_list_contactsList saved contactskeyid_create_contactCreate a contactkeyid_delete_contactDelete a contactkeyid_list_webhooksList webhookskeyid_create_webhookCreate webhookkeyid_get_webhook_deliveriesGet delivery historykeyid_manage_listAdd or remove from allow/blocklistkeyid_get_metricsQuery usage metricsEnvironment Variables
KEYID_BASE_URLAPI base URLKEYID_PUBLIC_KEYEd25519 public key (hex)KEYID_PRIVATE_KEYEd25519 private key (hex)Configuration
claude_desktop_config.json
{"mcpServers": {"keyid": {"command": "npx", "args": ["@keyid/agent-kit"], "env": {"KEYID_PUBLIC_KEY": "...hex...", "KEYID_PRIVATE_KEY": "...hex..."}}}}Try it
→Check my inbox for any new messages and summarize them.
→Reply to the latest email from Alice saying I will review the report today.
→Create a new contact for bob@partner.org.
→Set an auto-reply message for my email account while I am on vacation.
→List all my current conversation threads.