Imap Mcp Server

Name: Imap Mcp Server
Author: nikolausm

by nikolausmcommunityv1.3.0

An MCP server for managing IMAP email accounts, searching and reading mail, moving/marking/deleting messages, and sending/replying/forwarding mail via SMTP. It also supports folder operations, multiple accounts, encrypted credential storage, and a web-based setup wizard.

From the registry: IMAP/SMTP MCP server to search, read, organize, send, reply & forward email for AI assistants

GitHub Repository

Install & configure

Prerequisites

required
Node.js and npm
Required to run the server via npx.
https://nodejs.org/
optional
Set up at least one IMAP account
Configure an email account using the setup wizard or via the MCP tools. Account data is stored in ~/.imap-mcp/accounts.json and is shared across run modes.
```
$ npx -p imap-mcp-server imap-setup
```

Install in your client

Paste into the AI you're chatting with — it will figure out the rest

Please install the `imap-mcp-server` MCP server into my current AI client (that's you).

Required prerequisites (do these first if not already done):
- **Node.js and npm** — Required to run the server via npx. (https://nodejs.org/)

Optional prerequisites:
- Set up at least one IMAP account — Configure an email account using the setup wizard or via the MCP tools. Account data is stored in ~/.imap-mcp/accounts.json and is shared across run modes. Run: `npx -p imap-mcp-server imap-setup`

Canonical MCP server config (stdio transport):
- command: `npx`
- args: ["-y","imap-mcp-server"]

Note: Preferred install path is npx. The server does not require MCP config environment variables. It uses encrypted local account storage in ~/.imap-mcp/accounts.json, and accounts can be added later through the imap_add_account tool or via the setup wizard.

Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.

Note: Preferred install path is npx. The server does not require MCP config environment variables. It uses encrypted local account storage in ~/.imap-mcp/accounts.json, and accounts can be added later through the imap_add_account tool or via the setup wizard.

Tools (22)

imap_add_account

Add a new IMAP account

imap_list_accounts

List all configured accounts

imap_remove_account

Remove an account

imap_connect

Connect to an account

imap_disconnect

Disconnect from an account

imap_search_emails

Search for emails

imap_get_email

Get full email content

imap_get_latest_emails

Get recent emails

imap_mark_as_read/unread

Change email read status

imap_delete_email

Delete an email

imap_move_email

Move an email from one folder to another

imap_find_thread_messages

Find related messages in a thread across folders using IMAP header search

imap_download_attachment

Download an email attachment or extract text from PDFs

imap_bulk_delete

Delete multiple emails at once

Packages

imap-mcp-server

npmv1.3.0transport: stdio

Details

Language: TypeScript
License: MIT
Released: Jun 18, 2026
Last commit: Jun 5, 2026
Registry name: io.github.nikolausm/imap-mcp-server

Related Servers

Reddit Mcp Buddy

Reddit browser for AI assistants. Browse posts, search content, analyze users. No API keys needed.

752

Xactions

Twitter X automation MCP - post schedule analytics engagement social media

383

Mcp Whatsapp Cloud

MCP server for WhatsApp Cloud API (Meta) — messages, media, and templates via Graph API

261