Mailwarden Gmail MCP server

Mailwarden is a small helper program that connects your AI assistant to your real Gmail mailbox. Once it is set up, you can ask your AI in plain words to find, sort, clean up or snooze emails, and it will actually do it in Gmail. It is handy if your inbox is a mess and you would rather describe what you want than click around.

What this MCP server does

You type a request to your AI, like find unread mail from my bank or archive everything from this newsletter. Your AI sends that request to mailwarden, which is running quietly on your own computer. Mailwarden then talks directly to the live Gmail service, not a stale copy, and checks what is really in your mailbox. It can search, read, label, archive, trash, download attachments and snooze threads until a date you choose. Then it hands the result back to your AI, which explains it to you in the chat.

Click to zoom

What you can do with it

• Search your mailbox with normal Gmail search terms and get only real matches
• Read a whole email thread, including sender verification details
• Add or remove labels on one thread or on thousands at once
• Archive or move threads out of your inbox in bulk
• Move threads to trash without permanently deleting them
• Download attachments from a message to your computer
• Snooze a thread so it leaves your inbox now and comes back on a date you pick

Try asking your AI

• “Find all unread emails from the last week and show me a summary”
• “Archive every thread with the label Newsletters”
• “Snooze this thread until next Monday morning”
• “Download the attachment from the latest invoice email”

What it gives back to you

You get answers in the chat: lists of matching threads with sender, subject and date, short summaries of what a thread says, and confirmation of changes it made, like archived 42 threads or added label Receipts. For attachments, it saves the file to a folder you allow and tells you where it went. If something fails, it tells you in plain words whether you can retry or need to reconnect your account.

Before you start

Who it's for

Anyone who lives in Gmail all day, like an assistant, office manager, founder or support person, and wants to clean up and triage mail by describing it instead of clicking.