MailMCP — Documentation — Guide de démarrage

MailMCP Getting Started Guide

This guide walks you through creating your account to your first email command via your AI agent.

Create your account

Go to mailmcp.io/register. Enter your name, email and password. No credit card required for the free plan.

Add a mailbox

From the dashboard, go to Email accounts and click on + Add an account. A 3-step wizard guides you:

Step 1 — Configuration

Enter your email address. IMAP/SMTP servers and username are pre-filled automatically if your provider is recognized (Gmail, Outlook, OVH, LWS, Free, Orange...). Otherwise, mail.yourdomain.com is used by default. SSL connection required (IMAP:993, SMTP:465).

Step 2 — Diagnostic

MailMCP automatically tests the IMAP and SMTP connection with your credentials, and checks anti-spam DNS records (SPF, DKIM, DMARC). If an issue is detected, precise recommendations tell you what to ask your email provider.

Step 3 — MCP Server

The MCP server URL and your OAuth credentials (Client ID + Client Secret) are generated automatically. You will use them to connect your AI agent.

Get your MCP credentials

After adding, you are redirected to your account detail page. There you will find:

• MCP server URL — the address to enter in your AI client
• Client ID — your unique identifier, copyable in one click
• Client Secret — shown only once at creation, then hidden (revealable/copyable at any time)

Connect your AI agent

From the account detail page, click on the guide for your tool (Claude.ai, Claude Desktop, Cursor, ChatGPT, n8n...). Each guide gives you the exact configuration to copy-paste.

Test it!

In your AI agent, try:

« Summarize my latest unread emails »

Dashboard features

Overview

Quick stats: number of email accounts, CardDAV address books, synced contacts, and active MCP connections.

Email accounts

Add, test and manage your IMAP/SMTP accounts. Each account shows its connection status (IMAP check/cross, SMTP check/cross), its anti-spam score (SPF, DKIM, DMARC) and its MCP credentials. You can re-test the connection and regenerate credentials at any time.

CardDAV address books

Connect your CardDAV address books (Nextcloud, Baikal, iCloud, Fastmail, SOGo, Radicale...) to sync your contacts. Each address book shows its sync status and contact count.

MCP credentials & security

Each email account has a unique OAuth Client ID and Client Secret. The secret is AES-256 encrypted at rest. You can reveal, copy or regenerate it (immediately revokes the old one). No email content is stored on our servers.

Available MCP tools

15 tools are available via the MCP protocol. Your AI agent can use them in natural language.

Reading

list_emails List emails with filters
read_email Read full content
search_emails Search by sender/subject/content

Sending

send_email Send immediately (with CC)
draft_email Save as draft
schedule_email Schedule for later

Organizing

move_email Move to folder
delete_email Delete permanently
mark_read / mark_unread
flag_email Flag / unflag

Folders

list_mailboxes List all folders
create_folder Create a new folder

Scheduled

list_scheduled List pending emails
cancel_scheduled Cancel a scheduled email

Frequently asked questions

Are my email credentials stored in plain text?

No. Your passwords are encrypted with AES-256 using the Laravel application key. They are never exposed in the interface after entry.

What happens if I regenerate my MCP credentials?

A new Client ID and Client Secret are created. The old ones are immediately revoked — your AI agents will need to be reconfigured with the new credentials.

How many mailboxes can I connect?

The free plan includes 1 mailbox (read-only, 20 calls/day). Paid plans allow unlimited mailboxes with 500 MCP calls/day per mailbox.

Does MailMCP store my email content?

No. MailMCP acts as an MCP proxy. Content flows directly between your mail server and your AI agent via IMAP/SMTP. Nothing is stored or indexed.

What do SPF, DKIM and DMARC mean?

SPF verifies that your server is authorized to send emails for your domain. DKIM cryptographically signs your emails. DMARC tells receiving servers how to handle unauthenticated emails. These 3 elements reduce the risk of your emails being marked as spam.

Prêt à connecter vos emails à l'IA ?

Créez votre compte en 30 secondes et récupérez vos identifiants MCP.

Démarrer gratuitement