Accounts 4
Add, list, test and remove connected mailboxes.
- email_list_accounts
- email_add_account
- email_remove_account
- email_test_account
You
What needs me today? Across all four accounts.
Assistant
Connecting 0 messages across 1 account, 0 unread. Sample inbox: nothing here is real mail.
email_list_accountsOne server for Gmail, Outlook, iCloud and generic IMAP. It runs on your machine and talks to your provider's own API. No server of ours ever sees your inbox. Read how.
Sample data, generated for this page1 of 4 accounts connected
You
Which of these actually need a reply from me?
Assistant
Searched all four accounts in compact mode, so the results stay small until you ask for a body. 0 of 0 need you.
email_search · returnBody: falseCompact results: headers only, bodies on request7 rows
You
Archive every newsletter older than a week, and block the three senders I never open.
Assistant
Selecting. 0 of 0 match.
email_search · category: newsletters
Assistant
Moved 0 messages to Archive in one call. Inbox is at 0.
email_batch_move · 1 call
Assistant
Three standing rules created. Mail from those senders never reaches the inbox again, and each rule can be listed or deleted later.
email_create_block_rule · 3 callsBatch tools take hundreds of ids per call. Gmail up to 1,000, Outlook in batches of 20, IMAP by UID range.
Standing block rules
Sample data, generated for this pageArchive: 0
32 tools. Six categories. Every name real.
The full list with exact parameters is in the README. This is the surface an assistant sees when it connects.
Reading and search 6
Compact by default, full body on request. Attachments to disk without the base64 round trip.
- email_list_folders
- email_search
- email_get
- email_get_thread
- email_get_attachment
- email_save_attachment
Sending and drafts 6
Send, reply, forward. Drafts you can create, update in place and list.
- email_send
- email_reply
- email_forward
- email_draft_create
- email_draft_update
- email_draft_list
Organization 8
Move, transfer between accounts, delete, mark, label, folders and categories.
- email_move
- email_transfer
- email_delete
- email_mark
- email_label
- email_folder_create
- email_get_labels
- email_get_categories
Batch operations 3
The same actions across hundreds of messages in a single call.
- email_batch_delete
- email_batch_move
- email_batch_mark
Spam moderation 5
Train the provider's own filter, and keep standing block rules per provider.
- email_report_spam
- email_batch_report_spam
- email_create_block_rule
- email_list_block_rules
- email_delete_block_rule
Worth knowing
- Credentials
- Stored in
~/.email-mcpon your machine, AES-256-GCM encrypted with a key derived from the machine. - OAuth
- Gmail and Outlook use a shared app by default. Set
EMAIL_MCP_GMAIL_CLIENT_IDto bring your own. - Gmail scope
- The default permits permanent deletion. Choose
restrictedduring setup to drop it.
Assistant
Ready when you are. One command adds your accounts in the terminal, then point your client at the server and the tools show up.
No account with us, no dashboard, no lock-in. Uninstall by removing the npm package; your accounts and tokens stay in ~/.email-mcp.
claude_desktop_config.json