About io.github.openagentemail/mcp
io.github.openagentemail/mcp is an MCP server in the Communication category: unlimited agent mailboxes — create identities, read/wait for mail, extract OTPs, send email.
Install
claude mcp add io-github-openagentemail-mcp -- npx -y @openagentemail/mcpnpx -y @openagentemail/mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (20)
mail_list_identities()List all identities
Parameters not published.
mail_list_messages(address, limit?)List messages for an address (id/from/to/subject/date/seen/snippet)
Parameters not published.
mail_mark_seen(address, id, seen?)Mark a message read (default) or unread — reading never changes the flag by itself
Parameters not published.
mail_new_identity(name?, localpart?, scopes?)Admin only: create an identity and one-time token; pass `scopes: ["read:messages"]` for read-only own-mailbox access, `scopes: []` for no API operation permissions, or omit for legacy full identity permissions
Parameters not published.
mail_read_message(address, id)Full message: text, html?, and `otp:{codes:[],links:[]}`
Parameters not published.
mail_send(from, to, subject, text, html?)Send mail; `from` must be an existing identity
Parameters not published.
mail_wait_for(address, fromContains?, subjectContains?, timeoutSec?)Block until a matching message arrives (default 120s, max 600s)
Parameters not published.
notify_agent(name, title, message, level?, tags?)Wake a named agent without exposing an ntfy topic or token
Parameters not published.
notify_check(since?)Read recent notifications for the calling identity only
Parameters not published.
notify_user(title, message, level?, tags?)Send a human alert (needs the server-side `can_notify_user` grant)
Parameters not published.
Show all 20 tools
notify_verify()Publish and poll a harmless server-side notification self-check
Parameters not published.
task_claim(id, leaseSec?)Claim a recipient task for an optional lease duration
Parameters not published.
task_create(to, subject, body?, kind?, approval?, wait?, parentTaskId?)Assign an ordinary email-backed task (required `body`) or typed approval (`kind: "approval"` with required `approval:{action,expiresAt}`); `parentTaskId` selects a durable readable parent
Parameters not published.
task_decide(id, decision)Stored reviewer approves or rejects a pending typed approval
Parameters not published.
task_get(id, wait?)Read a task thread and its stamped state history; optionally wait up to 10 minutes
Parameters not published.
task_list(state?)List task threads visible to the calling identity
Parameters not published.
task_list_children(parentTaskId, limit?, cursor?)List only direct children readable by the current viewer, with 20/50/100 pagination, a parent/viewer/limit-scoped cursor, and no totals or descendants
Parameters not published.
task_release(id, leaseToken, reason?)Release a claimed task using its opaque bearer
Parameters not published.
task_renew(id, leaseToken, leaseSec?)Renew a claimed task using its opaque bearer
Parameters not published.
task_update(id, state, body?, result?, leaseToken?)Advance a participating task; structured output goes in `result`
Parameters not published.
Ask AI
Ask AI about io.github.openagentemail/mcp
Powered by Claude · Grounded in docs
Security checks
6 checks have not been run yet.