Mailwarden MCP
A native Gmail MCP server providing full mailbox triage for AI assistants. It features mailbox-side snooze using dated labels, trusted search with live label verification, sender authentication via SPF/DKIM/DMARC headers, and scalable bulk operations. It prioritizes security by excluding send tools by default and offering structured outputs.
Package and access
Local package with source-attributed installation metadata. Koskamo does not execute packages during review.
What you can do with it
- Snooze email threads to resurface them later
- Search Gmail threads with verified unread status
- Authenticate senders using SPF/DKIM/DMARC results
- Bulk archive or label messages matching a query
Source and maintenance
- Last repository push
- Latest release
- v0.27.1
- Maintenance checked
Packages and installation
Source-provided package data. Koskamo has not executed or live-probed this package.
mailwarden 0.27.1
{
"version": "0.27.1",
"transport": "stdio",
"identifier": "mailwarden",
"registryType": "npm",
"environmentVariables": [
{
"name": "MAILWARDEN_DIR",
"description": "Config directory (default ~/.mailwarden), holds credentials.json and token.json"
},
{
"name": "MAILWARDEN_CREDENTIALS",
"description": "Path to the Google OAuth credentials.json (Desktop app client)"
},
{
"name": "MAILWARDEN_AUTO_SWEEP",
"description": "Set to 1 to sweep due snoozes at startup and hourly while running"
},
{
"name": "MAILWARDEN_DOWNLOAD_DIR",
"description": "Restrict download_attachment and export_thread writes to this directory (recommended for HTTP hosting)"
}
]
}Tools
Reported by the attributed source; not independently observed by Koskamo.
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · repository · passed · metadata changed · updated
- · backfill · recorded · Pre-expansion baseline; unobserved rich metadata remains unknown
Connect from your client
Each snippet configures the same source-provided package; replace placeholders before use.
Cursor
{
"mcpServers": {
"mailwarden-mcp": {
"command": "npx",
"args": [
"-y",
"mailwarden@0.27.1"
],
"env": {
"MAILWARDEN_DIR": "<YOUR_MAILWARDEN_DIR>",
"MAILWARDEN_CREDENTIALS": "<YOUR_MAILWARDEN_CREDENTIALS>",
"MAILWARDEN_AUTO_SWEEP": "<YOUR_MAILWARDEN_AUTO_SWEEP>",
"MAILWARDEN_DOWNLOAD_DIR": "<YOUR_MAILWARDEN_DOWNLOAD_DIR>"
}
}
}
}Cline
{
"mcpServers": {
"mailwarden-mcp": {
"command": "npx",
"args": [
"-y",
"mailwarden@0.27.1"
],
"env": {
"MAILWARDEN_DIR": "<YOUR_MAILWARDEN_DIR>",
"MAILWARDEN_CREDENTIALS": "<YOUR_MAILWARDEN_CREDENTIALS>",
"MAILWARDEN_AUTO_SWEEP": "<YOUR_MAILWARDEN_AUTO_SWEEP>",
"MAILWARDEN_DOWNLOAD_DIR": "<YOUR_MAILWARDEN_DOWNLOAD_DIR>"
}
}
}
}VS Code
{
"servers": {
"mailwarden-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"mailwarden@0.27.1"
],
"env": {
"MAILWARDEN_DIR": "<YOUR_MAILWARDEN_DIR>",
"MAILWARDEN_CREDENTIALS": "<YOUR_MAILWARDEN_CREDENTIALS>",
"MAILWARDEN_AUTO_SWEEP": "<YOUR_MAILWARDEN_AUTO_SWEEP>",
"MAILWARDEN_DOWNLOAD_DIR": "<YOUR_MAILWARDEN_DOWNLOAD_DIR>"
}
}
}
}Claude Desktop
{
"mcpServers": {
"mailwarden-mcp": {
"command": "npx",
"args": [
"-y",
"mailwarden@0.27.1"
],
"env": {
"MAILWARDEN_DIR": "<YOUR_MAILWARDEN_DIR>",
"MAILWARDEN_CREDENTIALS": "<YOUR_MAILWARDEN_CREDENTIALS>",
"MAILWARDEN_AUTO_SWEEP": "<YOUR_MAILWARDEN_AUTO_SWEEP>",
"MAILWARDEN_DOWNLOAD_DIR": "<YOUR_MAILWARDEN_DOWNLOAD_DIR>"
}
}
}
}Let your agent find its tools
Find servers like Mailwarden MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.