@mailgent-dev/mcp

Identity infrastructure for AI agents — email, credentials, and TOTP in one place.

Quick Start

{
  "mcpServers": {
    "mailgent": {
      "command": "npx",
      "args": ["-y", "@mailgent-dev/mcp"],
      "env": {
        "MAILGENT_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Get your API key from console.mailgent.dev.

Examples

> Send an onboarding email to the new client
> Check my inbox and reply to the latest message
> Store my Stripe API key in the vault
> Get the TOTP code for my AWS account
> Delete the test thread I created earlier
> Post our launch announcement to X and LinkedIn
> Send a standup summary to #general on Slack

Tools

Identity

Tool	Description
identity_whoami	Get identity info — name, email, scopes

Email

Tool	Description
mail_send	Send email
mail_reply	Reply to a message
mail_list_messages	List inbox messages
mail_get_message	Get a specific message
mail_update_labels	Update message labels
mail_delete_message	Delete a message
mail_list_threads	List conversation threads
mail_get_thread	Get a full thread
mail_delete_thread	Delete a thread

Vault

Tool	Description
vault_list	List stored credentials
vault_get	Get a decrypted credential
vault_totp	Generate a TOTP code (response includes backupCodesRemaining)
vault_totp_use_backup	Atomically consume one TOTP backup code
vault_store	Store or update a credential (generic — any type)
vault_storeApiKey	Store an API key (single secret or OAuth client+secret pair)
vault_storeCard	Store a payment card — encrypted at rest, vault does not process payments
vault_storeShippingAddress	Store a shipping / mailing address
vault_delete	Delete a credential

Slack

Tool	Description
slack_send_message	Send a message to a Slack channel (set threadTs to reply in a thread)
slack_list_messages	List messages received in channels the connected bot is in, newest first
slack_list_channels	List workspace channels and whether the bot is a member

Social

Tool	Description
social_list_accounts	List connected social accounts (platform, username)
social_post	Publish a post to connected accounts — accounts are connected by your human in the Mailgent console (Settings → Integrations)
social_get_post	Check a post's status with per-platform results and live URLs

Multiple Identities

Each identity is its own MCP server instance:

{
  "mcpServers": {
    "sales-agent": {
      "command": "npx",
      "args": ["-y", "@mailgent-dev/mcp"],
      "env": { "MAILGENT_API_KEY": "mgnt-sales-key" }
    },
    "support-agent": {
      "command": "npx",
      "args": ["-y", "@mailgent-dev/mcp"],
      "env": { "MAILGENT_API_KEY": "mgnt-support-key" }
    }
  }
}

Docs

docs.mailgent.dev

License

MIT