IMAP MCP Server
Provides tools to list folders, list, search, and read messages (and mark them read/unread) in the IMAP mailbox whose mail is currently accessed through Nextcloud Mail, connecting directly to the underlying IMAP server rather than through Nextcloud.
Provides tools to list folders, list, search, and read messages (and mark them read/unread) in the IMAP mailbox whose mail is currently accessed through Roundcube webmail, connecting directly to the underlying IMAP server.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
IMAP MCP Server
Servidor MCP (Model Context Protocol) que expõe suas contas de e-mail via IMAP como ferramentas — para usar no ChatGPT (Developer Mode / Connectors) ou no Claude. Funciona com qualquer provedor IMAP padrão: no seu caso, os dois e-mails profissionais (um acessado hoje pelo Nextcloud Mail, outro pelo Roundcube). O Gmail pessoal fica de fora, já que você o conecta por outro plugin no ChatGPT.
Nextcloud Mail e Roundcube são só "vitrines" web — por trás deles sempre existe uma caixa IMAP de verdade, hospedada em algum servidor de e-mail. Este servidor conecta direto nessa caixa, sem depender do Nextcloud/Roundcube estarem abertos.
O que ele expõe
imap_list_accounts— lista as contas configuradasimap_list_folders— lista as pastas de uma conta (Inbox, Enviados, Spam...)imap_list_messages— lista as mensagens mais recentes de uma pastaimap_search_messages— busca por texto (assunto/remetente/corpo) numa contaimap_search_all_accounts— busca o mesmo texto nas DUAS contas de uma vezimap_get_message— lê o conteúdo completo de uma mensagemimap_mark_seen— marca como lida/não lida (reversível; o servidor não apaga nada)
Related MCP server: IMAP MCP Server
Passo 1 — Descobrir o servidor IMAP de cada conta
Você vai precisar, para CADA uma das 2 contas: endereço do servidor IMAP (host), porta, e se usa SSL/TLS. O login é o mesmo e-mail e senha que você já usa no Nextcloud Mail / Roundcube.
Conta acessada pelo Nextcloud Mail:
Abra o app Mail do Nextcloud → ícone de engrenagem (⚙) → clique na conta → "Configurações da conta" / "Editar conta".
Ele mostra os campos IMAP: servidor, porta e tipo de criptografia (normalmente SSL/TLS, porta 993).
Conta acessada pelo Roundcube:
O Roundcube geralmente não mostra essas configurações direto na interface (quem define é o provedor de hospedagem).
Caminhos mais rápidos: veja o painel de controle da hospedagem (cPanel, Plesk, etc.) na seção de contas de e-mail — costuma ter uma página "Configurar cliente de e-mail" com host/porta prontos. Ou pergunte ao suporte/TI responsável pelo domínio.
Palpite comum (nem sempre certo):
mail.seudominio.com.br, porta993, SSL/TLS.
Se quiser, me diga os domínios dos dois e-mails (sem me mandar a senha) que te ajudo a sugerir os hosts mais prováveis a testar.
Passo 2 — Testar as credenciais antes de colocar no servidor (opcional, recomendado)
Com Node instalado localmente, num terminal:
node -e "
const {ImapFlow} = require('imapflow');
const c = new ImapFlow({host:'SEU_HOST', port:993, secure:true, auth:{user:'seu@email.com', pass:'sua-senha'}, logger:false});
c.connect().then(() => { console.log('OK, conectou!'); return c.logout(); }).catch(e => console.error('ERRO:', e.message));
"(rode npm install imapflow numa pasta qualquer antes, se der erro de módulo não encontrado)
Passo 3 — Subir o código para o GitHub
cd imap-mcp
git init
git add -A
git config user.email "seu-email@exemplo.com"
git config user.name "Seu Nome"
git commit -m "IMAP MCP server"
git branch -M main
git remote add origin https://github.com/SEU-USUARIO/imap-mcp.git
git push -u origin main(crie o repositório vazio antes em https://github.com/new, nome imap-mcp)
Passo 4 — Deploy no Render (grátis)
https://dashboard.render.com → New + → Web Service → conecte o repositório
imap-mcp.Confirme:
Build Command:
npm install && npm run buildStart Command:
npm startPlan: Free
Em Environment Variables, adicione:
IMAP_ACCOUNTS→ um JSON com as duas contas, tudo em uma linha só, por exemplo:[{"id":"trabalho1","label":"Trabalho (Nextcloud)","host":"mail.dominio1.com","port":993,"secure":true,"user":"voce@dominio1.com","pass":"SUA_SENHA_1"},{"id":"trabalho2","label":"Trabalho (Roundcube)","host":"mail.dominio2.com","port":993,"secure":true,"user":"voce@dominio2.com","pass":"SUA_SENHA_2"}]MCP_SHARED_SECRET→ invente uma senha longa e aleatória (essencial aqui — sem isso, qualquer um com a URL leria seus e-mails)
Clique em Deploy. Anote a URL pública gerada, ex:
https://imap-mcp-xxxx.onrender.com
O endpoint MCP fica em https://imap-mcp-xxxx.onrender.com/mcp.
Nota: no plano free o serviço "dorme" após inatividade e demora ~30-50s pra acordar na primeira chamada seguinte.
Passo 5 — Conectar no ChatGPT
ChatGPT → Settings → Connectors → Advanced → Developer mode (ou Create custom connector, dependendo do plano).
Nome: "E-mails (IMAP)".
URL:
https://imap-mcp-xxxx.onrender.com/mcpAutenticação: API Key / Bearer Token, colando o mesmo valor de
MCP_SHARED_SECRET.Teste pedindo: "busca em todos os meus e-mails por [assunto]" — isso aciona
imap_search_all_accounts.
Segurança
Este servidor guarda as senhas das suas caixas de e-mail como variáveis de ambiente no Render — nunca no código.
MCP_SHARED_SECRETé obrigatório na prática: e-mail é dado sensível.O servidor só lê e marca como lida/não lida — não apaga, não move e não envia e-mails. Se quiser essas funções depois, dá pra adicionar.
Se alguma senha vazar ou precisar trocar, é só gerar uma nova no provedor de e-mail e atualizar a env var
IMAP_ACCOUNTSno Render (o serviço reinicia sozinho).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Email for AI agents: read, search and send from your Gmail, Outlook, Yahoo, iCloud or IMAP inbox.
Connect Gmail, iCloud Mail, Outlook, Yahoo Mail, Fastmail and other IMAP inboxes to ChatGPT, Claude and compatible AI assistants. Find emails by meaning across languages with semantic search. Ask AI to find customer conversations, summarize deadlines and draft follow-ups. Give a sales rep access to a shared outreach inbox or bring email into a compatible CRM. Share an iCloud custom-domain inbox with teammates without their own Apple ID or iCloud+ plan. Search results may be incomplete or stale; separate permissions control mail actions.
Connect any IMAP/SMTP mailbox to Claude & ChatGPT: search, read, sort, draft. Sends only with OK.
Email infrastructure for AI agents — send, receive, search, and reply to email over MCP.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables LLM clients to read and search email via IMAP with tools for listing folders, searching messages, and fetching message content. It supports pagination, snippets, and thread context, and is designed for local AI workflows.1013 npmMIT
- AlicenseNot gradedqualityAmaintenanceEnables AI assistants to search, read, send, reply, forward, organize, and bulk-delete email across multiple IMAP/SMTP accounts, with connection pooling and AES-256-encrypted credential storage. It also supports folder management, unread counts, provider presets, and runtime credential overrides via environment variables.1,009 npmMIT
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to search and read email, inspect attachments, and optionally send messages and organize folders through existing IMAP and SMTP mailboxes. Supports Docker, stdio, and HTTPS OAuth deployment with read-only or full-access modes.MIT
- AlicenseNot gradedqualityAmaintenanceEnables AI assistants to search, read, send, reply to, forward, move, mark, and bulk-delete email across multiple IMAP/SMTP mailboxes, plus manage folders and unread counts. Credentials are stored with AES-256 encryption and can be supplied via environment variables.1,009 npmMIT