{"name":"io.github.agenticmail/mcp","slug":"agenticmail-mcp","title":null,"description":"Real email and SMS for AI agents — send mail, receive verification codes, drive a real inbox.","url":"https://mcp.market/server/agenticmail-mcp","rating":null,"grade":"B","score":82,"certified":false,"status":"active","category":"email","tags":["email","productivity"],"presence":{"score":49,"stars":229,"forks":41,"downloads_week":182,"last_push_at":"2026-09-13T06:17:26.000Z","license":"MIT"},"uptime":null,"claimed":false,"transport":"npm","callable_via_gateway":false,"default_price_micros":0,"repository":"https://github.com/agenticmail/agenticmail","website":null,"version":"0.5.59","remotes":[],"packages":[{"registryType":"npm","identifier":"@agenticmail/mcp","version":"0.5.59","transport":{"type":"stdio"},"environmentVariables":[{"description":"Per-agent API key issued when you create the agent. Scopes every tool call to that agent's mailbox and outbound. Either AGENTICMAIL_API_KEY or AGENTICMAIL_MASTER_KEY must be set.","format":"string","isSecret":true,"name":"AGENTICMAIL_API_KEY"},{"description":"Master key for admin operations (creating agents, listing all accounts, deleting agents). Set this when the MCP client needs admin tools; otherwise prefer the per-agent AGENTICMAIL_API_KEY.","format":"string","isSecret":true,"name":"AGENTICMAIL_MASTER_KEY"},{"description":"Base URL of the AgenticMail HTTP API. Defaults to http://127.0.0.1:3100 (the port the local CLI binds). Override when the API runs on a different host or port.","format":"string","default":"http://127.0.0.1:3100","name":"AGENTICMAIL_API_URL"}]}],"tools":[{"name":"batch_delete","description":"Delete multiple emails by UIDs","write_action":true,"price_micros":0,"input_schema":null},{"name":"batch_mark_read","description":"Mark multiple emails as read","write_action":false,"price_micros":0,"input_schema":null},{"name":"batch_mark_unread","description":"Mark multiple emails as unread","write_action":false,"price_micros":0,"input_schema":null},{"name":"batch_move","description":"Move multiple emails to another folder","write_action":false,"price_micros":0,"input_schema":null},{"name":"batch_read","description":"Read multiple emails at once by UIDs. Returns full parsed content for each message in a single call.","write_action":false,"price_micros":0,"input_schema":null},{"name":"call_agent","description":"Synchronous RPC: assign a task to another agent, notify them via email (wakes wait_for_email), and wait for the result. Times out after specified duration.","write_action":false,"price_micros":0,"input_schema":null},{"name":"check_gateway_status","description":"Check the current email gateway status \\u2014 relay mode, domain mode, or not configured","write_action":false,"price_micros":0,"input_schema":null},{"name":"check_health","description":"Check \\u{1F380} AgenticMail server health status","write_action":false,"price_micros":0,"input_schema":null},{"name":"check_messages","description":"Check for new unread messages from other agents or external senders. Returns a summary of pending communications. Use this to stay aware of requests and coordinate with other agents.","write_action":false,"price_micros":0,"input_schema":null},{"name":"check_tasks","description":"Check for pending tasks assigned to you (or a specific agent) or tasks you assigned to others","write_action":false,"price_micros":0,"input_schema":null},{"name":"claim_task","description":"Claim a pending task assigned to you","write_action":false,"price_micros":0,"input_schema":null},{"name":"cleanup_agents","description":"List or remove inactive non-persistent agent accounts (requires master API key)","write_action":false,"price_micros":0,"input_schema":null},{"name":"create_account","description":"Create a new agent email account (requires master API key)","write_action":true,"price_micros":0,"input_schema":null},{"name":"create_folder","description":"Create a new mail folder for organizing emails","write_action":true,"price_micros":0,"input_schema":null},{"name":"delete_agent","description":"Delete an agent account. Archives all emails and generates a deletion report before removing the account permanently. Returns the deletion summary. Requires master API key.","write_action":true,"price_micros":0,"input_schema":null},{"name":"delete_email","description":"Delete an email by its UID","write_action":true,"price_micros":0,"input_schema":null},{"name":"deletion_reports","description":"List past agent deletion reports or retrieve a specific report by ID. Shows archived email summaries from deleted agents. Requires master API key.","write_action":false,"price_micros":0,"input_schema":null},{"name":"forward_email","description":"Forward an email to another recipient. Outbound guard applies \\u2014 HIGH severity content is held for review.","write_action":true,"price_micros":0,"input_schema":null},{"name":"import_relay_email","description":"Import an email from the connected Gmail/Outlook account into the agent's local inbox. This downloads the full message with all headers (Message-ID, In-Reply-To, References) so you can continue the thread using reply_email. Use search_emails with searchRelay=true first to find the relay UID.","write_action":true,"price_micros":0,"input_schema":null},{"name":"inbox_digest","description":"Get a compact inbox digest with subject, sender, date, flags and text preview for each message. More efficient than listing then reading individually.","write_action":false,"price_micros":0,"input_schema":null},{"name":"list_agents","description":"List all AI agents in the system with their email addresses and roles. Use this to discover which agents you can communicate with via message_agent.","write_action":false,"price_micros":0,"input_schema":null},{"name":"list_folder","description":"List messages in a specific folder","write_action":false,"price_micros":0,"input_schema":null},{"name":"list_folders","description":"List all mail folders/mailboxes","write_action":false,"price_micros":0,"input_schema":null},{"name":"list_inbox","description":"List recent emails in the agent's inbox","write_action":false,"price_micros":0,"input_schema":null},{"name":"manage_contacts","description":"List, add, or delete contacts","write_action":false,"price_micros":0,"input_schema":null},{"name":"manage_drafts","description":"List, create, update, send, or delete drafts","write_action":false,"price_micros":0,"input_schema":null},{"name":"manage_pending_emails","description":"Check the status of pending outbound emails blocked by the outbound guard. You can list all your pending emails or get details of a specific one. You CANNOT approve or reject \\u2014 only the owner can do that.","write_action":false,"price_micros":0,"input_schema":null},{"name":"manage_rules","description":"Manage server-side email rules that auto-process incoming messages (move, tag, mark read, delete).","write_action":false,"price_micros":0,"input_schema":null},{"name":"manage_scheduled","description":"Manage scheduled emails: create a new scheduled email, list pending ones, or cancel one. Accepts flexible time formats for create: ISO 8601, relative (\"in 30 minutes\"), named (\"tomorrow 8am\"), day-based (\"next monday 9am\"), or human-friendly (\"02-14-2026 3:30 PM EST\").","write_action":false,"price_micros":0,"input_schema":null},{"name":"manage_signatures","description":"List, create, or delete email signatures","write_action":false,"price_micros":0,"input_schema":null},{"name":"manage_spam","description":"Manage spam: list spam folder, report a message as spam, mark as not-spam, or get the spam score of a message. Emails are auto-scored on arrival; high-scoring messages are moved to Spam automatically.","write_action":false,"price_micros":0,"input_schema":null},{"name":"manage_tags","description":"Create, list, delete tags, tag/untag messages, get messages by tag, or get all tags for a specific message.","write_action":true,"price_micros":0,"input_schema":null},{"name":"manage_templates","description":"List, create, or delete email templates","write_action":false,"price_micros":0,"input_schema":null},{"name":"mark_read","description":"Mark an email as read","write_action":false,"price_micros":0,"input_schema":null},{"name":"mark_unread","description":"Mark an email as unread","write_action":false,"price_micros":0,"input_schema":null},{"name":"message_agent","description":"Send a message to another AI agent by name. The message is delivered to their email inbox. Use list_agents first to see available agents. This is the primary way for agents to coordinate and share information with each other.","write_action":true,"price_micros":0,"input_schema":null},{"name":"move_email","description":"Move an email to another folder (e.g., Trash, Archive)","write_action":true,"price_micros":0,"input_schema":null},{"name":"purchase_domain","description":"Search for available domains via Cloudflare Registrar (requires master API key). NOTE: Cloudflare API only supports READ access \\u2014 domains must be purchased manually at https://dash.cloudflare.com or from another registrar (then point nameservers to Cloudflare).","write_action":true,"price_micros":0,"input_schema":null},{"name":"read_email","description":"Read the full content of a specific email by its UID","write_action":true,"price_micros":0,"input_schema":null},{"name":"reply_email","description":"Reply to an email. Fetches the original message, auto-fills To, Subject (Re:), In-Reply-To, and References, then sends with quoted body. Outbound guard applies \\u2014 HIGH severity content is held for review.","write_action":true,"price_micros":0,"input_schema":null},{"name":"search_emails","description":"Search emails by criteria (from, to, subject, text, date range). By default searches the local inbox only. Set searchRelay=true to also search the connected Gmail/Outlook account \\u2014 results include relay UIDs that can be imported with import_relay_email.","write_action":false,"price_micros":0,"input_schema":null},{"name":"send_email","description":"Send an email from the agent's mailbox. External emails are scanned for sensitive content. HIGH severity detections are BLOCKED and held for owner approval. Your owner will be notified and must approve blocked emails. You CANNOT bypass the outbound guard.","write_action":true,"price_micros":0,"input_schema":null},{"name":"send_test_email","description":"Send a test email through the gateway to verify configuration (requires master API key)","write_action":true,"price_micros":0,"input_schema":null},{"name":"setup_email_domain","description":"Set up a custom domain for real internet email via Cloudflare (requires master API key). ADVANCED: Requires Cloudflare account, API token, and a domain. Emails send from agent@yourdomain.com with full DKIM/SPF/DMARC. Optionally configures Gmail SMTP as outbound relay (recommended for residential IPs). After setup with gmailRelay, use setup_gmail_alias for each agent.","write_action":true,"price_micros":0,"input_schema":null},{"name":"setup_email_relay","description":"Configure Gmail/Outlook relay for sending real internet email (requires master API key). BEGINNER-FRIENDLY: Just needs a Gmail/Outlook email + app password. Agents send as user+agentname@gmail.com. Automatically creates a default agent (secretary) unless skipped. Best for: quick setup, personal use, no domain needed.","write_action":true,"price_micros":0,"input_schema":null},{"name":"setup_gmail_alias","description":"Get step-by-step instructions (with exact field values) to add an agent email as a Gmail \"Send mail as\" alias. Returns the Gmail settings URL and all field values. Required after domain mode setup with gmailRelay to show correct From address. The agent can automate this via browser tools or present instructions to the user.","write_action":false,"price_micros":0,"input_schema":null},{"name":"setup_guide","description":"Get a comparison of email setup modes (Relay vs Domain) with difficulty levels, requirements, pros/cons, and step-by-step instructions. Show this to users who want to set up real internet email.","write_action":false,"price_micros":0,"input_schema":null},{"name":"setup_payment","description":"Get instructions for adding a payment method to Cloudflare (required before purchasing domains). Returns Option A (self-service link) and Option B (browser automation steps). Card details go directly to Cloudflare \\u2014 never stored by \\u{1F380} AgenticMail.","write_action":false,"price_micros":0,"input_schema":null},{"name":"sms_check_code","description":"Check for recent verification/OTP codes received via SMS. Scans inbound SMS for common code patterns (6-digit, 4-digit, alphanumeric). Use this after requesting a verification code during sign-up flows.","write_action":false,"price_micros":0,"input_schema":null},{"name":"sms_config","description":"Get the current SMS/phone number configuration for this agent. Shows whether SMS is enabled, the phone number, and forwarding email.","write_action":false,"price_micros":0,"input_schema":null},{"name":"sms_messages","description":"List SMS messages (inbound and outbound). Use direction filter to see only received or sent messages.","write_action":false,"price_micros":0,"input_schema":null},{"name":"sms_parse_email","description":"Parse an SMS from a forwarded Google Voice email. Use this when you receive an email from Google Voice containing an SMS. Extracts the sender number, message body, and any verification codes.","write_action":true,"price_micros":0,"input_schema":null},{"name":"sms_read_voice","description":"Get instructions and URL for reading SMS directly from Google Voice web (FASTEST method). Returns the voice.google.com URL and guidance for browser-based SMS reading. Primary method - much faster than email forwarding.","write_action":false,"price_micros":0,"input_schema":null},{"name":"sms_record","description":"Record an SMS message read from Google Voice web or any other source. Saves to SMS database and extracts verification codes. Use after reading a message from voice.google.com.","write_action":false,"price_micros":0,"input_schema":null},{"name":"sms_send","description":"Send an SMS text message via Google Voice. Records the message and provides instructions for sending via Google Voice web interface. The agent can automate the actual send using browser automation on voice.google.com.","write_action":true,"price_micros":0,"input_schema":null},{"name":"sms_setup","description":"Configure SMS/phone number access via Google Voice. The user must have a Google Voice account with SMS-to-email forwarding enabled. This gives the agent a phone number for receiving verification codes and sending texts.","write_action":false,"price_micros":0,"input_schema":null},{"name":"storage","description":"Full database management system for agents. 28 actions: DDL (create/alter/drop/clone/rename tables & columns), DML (insert/upsert/query/aggregate/update/delete/truncate), indexing (create/list/drop/reindex), import/export (JSON/CSV, conflict handling), raw SQL, maintenance (stats/vacuum/analyze/explain), archiving. WHERE supports operators: $gt, $gte, $lt, $lte, $ne, $like, $ilike, $in, $not_in, $","write_action":false,"price_micros":0,"input_schema":null},{"name":"submit_result","description":"Submit the result for a claimed task, marking it as completed","write_action":true,"price_micros":0,"input_schema":null},{"name":"template_send","description":"Send an email using a saved template with variable substitution. Variables like {{name}} are replaced.","write_action":true,"price_micros":0,"input_schema":null},{"name":"update_metadata","description":"Update the current agent's metadata. Merges provided keys with existing metadata.","write_action":true,"price_micros":0,"input_schema":null},{"name":"wait_for_email","description":"Wait for a new email or task notification using push notifications (SSE). Blocks until an email arrives, a task is assigned to you, or timeout is reached. Much more efficient than polling \\u2014 use this when waiting for a reply or a task from another agent.","write_action":true,"price_micros":0,"input_schema":null},{"name":"whoami","description":"Get the current agent's account info \\u2014 name, email, role, and metadata","write_action":false,"price_micros":0,"input_schema":null}],"scan":{"score":82,"grade":"B","scanned_at":"2026-09-27T21:46:37.701Z","report":{"scannerVersion":"0.1.9","scannedAt":"2026-09-27T21:46:37.674Z","components":{"code":{"score":25,"max":25,"notes":["3 source files scanned"]},"reliability":{"score":-1,"max":20,"notes":["no gateway calls yet and no remote to probe"]},"poisoning":{"score":-1,"max":15,"notes":["tools not inspected (local package is not executed); not counted"]},"auth":{"score":6,"max":15,"notes":["static API keys via environment variables"]},"maintenance":{"score":15,"max":15,"notes":["last push 15 days ago"]},"identity":{"score":7,"max":10,"notes":["registry namespace matches repository owner"]}},"findings":[],"inputs":{"packages":[{"registryType":"npm","identifier":"@agenticmail/mcp","version":"0.5.59","found":true,"license":"MIT","hasInstallScripts":false,"dependencyCount":3,"publishedAt":"2026-05-08T05:25:37.296Z","repositoryUrl":"git+https://github.com/agenticmail/agenticmail.git","weeklyDownloads":182}],"repo":{"found":true,"owner":"agenticmail","repo":"agenticmail","archived":false,"pushedAt":"2026-09-13T06:17:26Z","stars":229,"forks":41,"openIssues":11,"ownerType":"Organization","ownerAvatarUrl":"https://avatars.githubusercontent.com/u/261576724?v=4","ownerCreatedAt":"2026-02-14T08:07:27Z","license":"MIT"},"icon":{"url":"https://avatars.githubusercontent.com/u/261576724?v=4&s=128","source":"github"},"presence":{"stars":229,"forks":41,"downloadsWeek":182,"license":"MIT","lastPushAt":"2026-09-13T06:17:26.000Z","score":49}}}},"grade_history":[],"reviews":[]}