Servers Playground How we check Submit a server

MinuteMail

Working · 1.5 s

io.github.minutemailco/mcp-serverv1.1.3

Ephemeral mailboxes and a mock OAuth IdP for testing email and auth flows — 39 API-driven tools

Developer Tools Communication

Source Registry entry

Try it

Call this server's tools from your browser. Nothing to install.

https://mcp.minutemail.co/mcp

Authorization (required)

MinuteMail API key (Bearer mmak_...) — create one at https://minutemail.co

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

archived.delete

Permanently delete an archived mailbox.

mailboxIdstring, required

Archived mailbox ID

The server marks this tool as destructive. Running it may delete or overwrite data on the server or in any account you connected with your headers.

I understand, run it anyway

MinuteMail MCP server | mcptry

Tools (40)

archived.delete

Permanently delete an archived mailbox.

destructive

Argument	Type	Description
mailboxId*	string	Archived mailbox ID

Input schema (JSON)

{
  "type": "object",
  "required": [
    "mailboxId"
  ],
  "properties": {
    "mailboxId": {
      "type": "string",
      "description": "Archived mailbox ID"
    }
  }
}

archived.get

Fetch a single archived mailbox by ID.

read-only

Argument	Type	Description
mailboxId*	string	Archived mailbox ID

Input schema (JSON)

{
  "type": "object",
  "required": [
    "mailboxId"
  ],
  "properties": {
    "mailboxId": {
      "type": "string",
      "description": "Archived mailbox ID"
    }
  }
}

archived.list

List the tenant's archived (expired but recoverable) mailboxes.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {}
}

archived.reactivate

Reactivate an archived mailbox back to active state.

Argument	Type	Description
expiresIn	integer	New lifetime in minutes, 1-60. Optional.
mailboxId*	string	Archived mailbox ID

Input schema (JSON)

{
  "type": "object",
  "required": [
    "mailboxId"
  ],
  "properties": {
    "expiresIn": {
      "type": "integer",
      "description": "New lifetime in minutes, 1-60. Optional."
    },
    "mailboxId": {
      "type": "string",
      "description": "Archived mailbox ID"
    }
  }
}

attachments.add

Attach a file to a test-injected email (base64 payload).

Argument	Type	Description
data*	string	File contents, standard base64
mailId*	string	Mail ID
filename*	string	Attachment file name
expiresIn	integer	Attachment lifetime in minutes (>=1). Optional.
mailboxId*	string	Mailbox ID
sizeBytes	integer	Expected size in bytes. Optional; validated against the decoded data when set.
contentType	string	MIME type, defaults to application/octet-stream

Input schema (JSON)

{
  "type": "object",
  "required": [
    "mailboxId",
    "mailId",
    "filename",
    "data"
  ],
  "properties": {
    "data": {
      "type": "string",
      "description": "File contents, standard base64"
    },
    "mailId": {
      "type": "string",
      "description": "Mail ID"
    },
    "filename": {
      "type": "string",
      "description": "Attachment file name"
    },
    "expiresIn": {
      "type": "integer",
      "description": "Attachment lifetime in minutes (>=1). Optional."
    },
    "mailboxId": {
      "type": "string",
      "description": "Mailbox ID"
    },
    "sizeBytes": {
      "type": "integer",
      "description": "Expected size in bytes. Optional; validated against the decoded data when set."
    },
    "contentType": {
      "type": "string",
      "description": "MIME type, defaults to application/octet-stream"
    }
  }
}

attachments.delete

Delete a single attachment.

destructive

Argument	Type	Description
mailId*	string	Mail ID
mailboxId*	string	Mailbox ID
attachmentId*	string	Attachment ID

Input schema (JSON)

{
  "type": "object",
  "required": [
    "mailboxId",
    "mailId",
    "attachmentId"
  ],
  "properties": {
    "mailId": {
      "type": "string",
      "description": "Mail ID"
    },
    "mailboxId": {
      "type": "string",
      "description": "Mailbox ID"
    },
    "attachmentId": {
      "type": "string",
      "description": "Attachment ID"
    }
  }
}

attachments.delete_bulk

Delete several attachments of one email at once.

destructive

Argument	Type	Description
ids*	array	Attachment IDs to delete
mailId*	string	Mail ID
mailboxId*	string	Mailbox ID

Input schema (JSON)

{
  "type": "object",
  "required": [
    "mailboxId",
    "mailId",
    "ids"
  ],
  "properties": {
    "ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Attachment IDs to delete"
    },
    "mailId": {
      "type": "string",
      "description": "Mail ID"
    },
    "mailboxId": {
      "type": "string",
      "description": "Mailbox ID"
    }
  }
}

attachments.get

Download an attachment. The file contents are returned base64-encoded in the JSON "data" field.

read-only

Argument	Type	Description
mailId*	string	Mail ID
mailboxId*	string	Mailbox ID
attachmentId*	string	Attachment ID

Input schema (JSON)

{
  "type": "object",
  "required": [
    "mailboxId",
    "mailId",
    "attachmentId"
  ],
  "properties": {
    "mailId": {
      "type": "string",
      "description": "Mail ID"
    },
    "mailboxId": {
      "type": "string",
      "description": "Mailbox ID"
    },
    "attachmentId": {
      "type": "string",
      "description": "Attachment ID"
    }
  }
}

attachments.list

List the attachments of an email (metadata only).

read-only

Argument	Type	Description
mailId*	string	Mail ID
mailboxId*	string	Mailbox ID

Input schema (JSON)

{
  "type": "object",
  "required": [
    "mailboxId",
    "mailId"
  ],
  "properties": {
    "mailId": {
      "type": "string",
      "description": "Mail ID"
    },
    "mailboxId": {
      "type": "string",
      "description": "Mailbox ID"
    }
  }
}

domains.delete

Delete a registered custom domain.

destructive

Argument	Type	Description
domainId*	string	Domain ID

Input schema (JSON)

{
  "type": "object",
  "required": [
    "domainId"
  ],
  "properties": {
    "domainId": {
      "type": "string",
      "description": "Domain ID"
    }
  }
}

domains.list

List the tenant's custom domains with their DNS verification status.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {}
}

domains.register

Argument	Type	Description
name*	string	Domain name, e.g. mail.example.com

Input schema (JSON)

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Domain name, e.g. mail.example.com"
    }
  }
}

domains.verify

Trigger DNS verification (TXT + MX) of a registered domain.

Argument	Type	Description
domainId*	string	Domain ID

Input schema (JSON)

{
  "type": "object",
  "required": [
    "domainId"
  ],
  "properties": {
    "domainId": {
      "type": "string",
      "description": "Domain ID"
    }
  }
}

identities.create

Create a mock identity bound to a mailbox for OAuth flow testing.

Argument	Type	Description
name	string	Display name. Optional.
claims	object	Custom claims (e.g. role, plan) merged into the ID token and userinfo. Custom-provider clients only — rejected for google/github/apple/facebook. Optional.
clientId*	string	OAuth client ID the identity belongs to
username	string	Identity username. Optional.
avatarUrl	string	Avatar URL. Optional.
emailVerified	boolean	Value of the email_verified claim issued for this identity. Optional.
mailboxAddress*	string	Mailbox address the identity is linked to (must exist)

Input schema (JSON)

{
  "type": "object",
  "required": [
    "clientId",
    "mailboxAddress"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Display name. Optional."
    },
    "claims": {
      "type": "object",
      "description": "Custom claims (e.g. role, plan) merged into the ID token and userinfo. Custom-provider clients only — rejected for google/github/apple/facebook. Optional.",
      "additionalProperties": {
        "type": "string"
      }
    },
    "clientId": {
      "type": "string",
      "description": "OAuth client ID the identity belongs to"
    },
    "username": {
      "type": "string",
      "description": "Identity username. Optional."
    },
    "avatarUrl": {
      "type": "string",
      "description": "Avatar URL. Optional."
    },
    "emailVerified": {
      "type": "boolean",
      "description": "Value of the email_verified claim issued for this identity. Optional."
    },
    "mailboxAddress": {
      "type": "string",
      "description": "Mailbox address the identity is linked to (must exist)"
    }
  }
}

identities.delete

Delete a mock identity.

destructive

Argument	Type	Description
identityId*	string	Identity ID

Input schema (JSON)

{
  "type": "object",
  "required": [
    "identityId"
  ],
  "properties": {
    "identityId": {
      "type": "string",
      "description": "Identity ID"
    }
  }
}

identities.get

Fetch a single mock identity by ID.

read-only

Argument	Type	Description
identityId*	string	Identity ID

Input schema (JSON)

{
  "type": "object",
  "required": [
    "identityId"
  ],
  "properties": {
    "identityId": {
      "type": "string",
      "description": "Identity ID"
    }
  }
}

identities.list

List the tenant's mock identities, optionally filtered by OAuth client or mailbox address.

read-only

Argument	Type	Description
clientId	string	Filter by OAuth client ID. Optional.
mailboxAddress	string	Filter by mailbox address. Optional.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "clientId": {
      "type": "string",
      "description": "Filter by OAuth client ID. Optional."
    },
    "mailboxAddress": {
      "type": "string",
      "description": "Filter by mailbox address. Optional."
    }
  }
}

identities.update

Update a mock identity: profile fields, isActive (activate/deactivate), emailVerified, and custom claims merged into the ID token and userinfo.

Argument	Type	Description
name	string	Display name. Optional.
claims	object	Custom claims (e.g. role, plan) merged into the ID token and userinfo. Replaces existing claims. Reserved claim names are rejected. Optional.
isActive	boolean	Whether the identity can be used in OAuth flows. Optional.
username	string	Identity username. Optional.
avatarUrl	string	Avatar URL. Optional.
identityId*	string	Identity ID
emailVerified	boolean	Value of the email_verified claim issued for this identity. Optional.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "identityId"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Display name. Optional."
    },
    "claims": {
      "type": "object",
      "description": "Custom claims (e.g. role, plan) merged into the ID token and userinfo. Replaces existing claims. Reserved claim names are rejected. Optional.",
      "additionalProperties": {
        "type": "string"
      }
    },
    "isActive": {
      "type": "boolean",
      "description": "Whether the identity can be used in OAuth flows. Optional."
    },
    "username": {
      "type": "string",
      "description": "Identity username. Optional."
    },
    "avatarUrl": {
      "type": "string",
      "description": "Avatar URL. Optional."
    },
    "identityId": {
      "type": "string",
      "description": "Identity ID"
    },
    "emailVerified": {
      "type": "boolean",
      "description": "Value of the email_verified claim issued for this identity. Optional."
    }
  }
}

mailboxes.create

Create a new temporary mailbox. The domain defaults to the tenant's default domain; the owner is always the API key's owner.

Argument	Type	Description
tag	string	Recovery tag, required when recoverable is true.
domain	string	Mailbox domain. Defaults to the tenant default domain (e.g. minutemail.cc).
expiresIn	integer	Lifetime in minutes, 1-60. Omit for the service default TTL.
recoverable	boolean	Set true to keep the mailbox recoverable after expiry (requires tag).
noExpiration	boolean	Set true for a permanent mailbox (mutually exclusive with expiresIn).

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "tag": {
      "type": "string",
      "description": "Recovery tag, required when recoverable is true."
    },
    "domain": {
      "type": "string",
      "description": "Mailbox domain. Defaults to the tenant default domain (e.g. minutemail.cc)."
    },
    "expiresIn": {
      "type": "integer",
      "description": "Lifetime in minutes, 1-60. Omit for the service default TTL."
    },
    "recoverable": {
      "type": "boolean",
      "description": "Set true to keep the mailbox recoverable after expiry (requires tag)."
    },
    "noExpiration": {
      "type": "boolean",
      "description": "Set true for a permanent mailbox (mutually exclusive with expiresIn)."
    }
  }
}

mailboxes.delete

Delete a mailbox and its contents by ID.

destructive

Argument	Type	Description
mailboxId*	string	Mailbox ID

Input schema (JSON)

{
  "type": "object",
  "required": [
    "mailboxId"
  ],
  "properties": {
    "mailboxId": {
      "type": "string",
      "description": "Mailbox ID"
    }
  }
}

mailboxes.delete_bulk

Delete several mailboxes at once by ID.

destructive

Argument	Type	Description
ids*	array	Mailbox IDs to delete

Input schema (JSON)

{
  "type": "object",
  "required": [
    "ids"
  ],
  "properties": {
    "ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Mailbox IDs to delete"
    }
  }
}

mailboxes.get

Fetch a single mailbox by ID.

read-only

Argument	Type	Description
mailboxId*	string	Mailbox ID

Input schema (JSON)

{
  "type": "object",
  "required": [
    "mailboxId"
  ],
  "properties": {
    "mailboxId": {
      "type": "string",
      "description": "Mailbox ID"
    }
  }
}

mailboxes.list

List the tenant's active mailboxes (owner is derived from the API key). Optionally look up a single mailbox by exact address.

read-only

Argument	Type	Description
address	string	Exact mailbox address to look up (e.g. [email protected]). Optional.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "description": "Exact mailbox address to look up (e.g. [email protected]). Optional."
    }
  }
}

mails.delete

Delete a single email.

destructive

Argument	Type	Description
mailId*	string	Mail ID
mailboxId*	string	Mailbox ID

Input schema (JSON)

{
  "type": "object",
  "required": [
    "mailboxId",
    "mailId"
  ],
  "properties": {
    "mailId": {
      "type": "string",
      "description": "Mail ID"
    },
    "mailboxId": {
      "type": "string",
      "description": "Mailbox ID"
    }
  }
}

mails.delete_bulk

Delete several emails of one mailbox at once.

destructive

Argument	Type	Description
ids*	array	Mail IDs to delete
mailboxId*	string	Mailbox ID

Input schema (JSON)

{
  "type": "object",
  "required": [
    "mailboxId",
    "ids"
  ],
  "properties": {
    "ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Mail IDs to delete"
    },
    "mailboxId": {
      "type": "string",
      "description": "Mailbox ID"
    }
  }
}

mails.get

Fetch a single email by ID, including body and attachment metadata.

read-only

Argument	Type	Description
mailId*	string	Mail ID
mailboxId*	string	Mailbox ID

Input schema (JSON)

{
  "type": "object",
  "required": [
    "mailboxId",
    "mailId"
  ],
  "properties": {
    "mailId": {
      "type": "string",
      "description": "Mail ID"
    },
    "mailboxId": {
      "type": "string",
      "description": "Mailbox ID"
    }
  }
}

mails.inject

Inject a simulated inbound email into a mailbox (multipart upload). No external mail is sent; use this to simulate inbound mail for flow testing.

Argument	Type	Description
body*	string	Plain-text body
sender*	string	Sender email address
subject*	string	Email subject
expiresIn	integer	Mail lifetime in minutes (>=1). Optional.
mailboxId*	string	Mailbox ID
attachments	array	Attachments to include

Input schema (JSON)

{
  "type": "object",
  "required": [
    "mailboxId",
    "sender",
    "subject",
    "body"
  ],
  "properties": {
    "body": {
      "type": "string",
      "description": "Plain-text body"
    },
    "sender": {
      "type": "string",
      "description": "Sender email address"
    },
    "subject": {
      "type": "string",
      "description": "Email subject"
    },
    "expiresIn": {
      "type": "integer",
      "description": "Mail lifetime in minutes (>=1). Optional."
    },
    "mailboxId": {
      "type": "string",
      "description": "Mailbox ID"
    },
    "attachments": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "filename",
          "data"
        ],
        "properties": {
          "data": {
            "type": "string",
            "description": "File contents, standard base64"
          },
          "filename": {
            "type": "string",
            "description": "Attachment file name"
          },
          "contentType": {
            "type": "string",
            "description": "MIME type, defaults to application/octet-stream"
          }
        }
      },
      "description": "Attachments to include"
    }
  }
}

mails.list

List the emails in a mailbox, newest first.

read-only

Argument	Type	Description
mailboxId*	string	Mailbox ID

Input schema (JSON)

{
  "type": "object",
  "required": [
    "mailboxId"
  ],
  "properties": {
    "mailboxId": {
      "type": "string",
      "description": "Mailbox ID"
    }
  }
}

oauth.clients.create

Argument	Type	Description
name*	string	Client display name
providerType	string	Identity provider type
redirectUris*	array	Allowed redirect URIs (at least one)
providerLabel	string	Custom provider label. Required when providerType is custom.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "name",
    "redirectUris"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Client display name"
    },
    "providerType": {
      "enum": [
        "google",
        "github",
        "apple",
        "facebook",
        "custom"
      ],
      "type": "string",
      "description": "Identity provider type"
    },
    "redirectUris": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Allowed redirect URIs (at least one)"
    },
    "providerLabel": {
      "type": "string",
      "description": "Custom provider label. Required when providerType is custom."
    }
  }
}

oauth.clients.delete

Delete an OAuth client by its public client ID.

destructive

Argument	Type	Description
clientId*	string	Public OAuth client ID

Input schema (JSON)

{
  "type": "object",
  "required": [
    "clientId"
  ],
  "properties": {
    "clientId": {
      "type": "string",
      "description": "Public OAuth client ID"
    }
  }
}

oauth.clients.get

Fetch a single OAuth client by its public client ID.

read-only

Argument	Type	Description
clientId*	string	Public OAuth client ID

Input schema (JSON)

{
  "type": "object",
  "required": [
    "clientId"
  ],
  "properties": {
    "clientId": {
      "type": "string",
      "description": "Public OAuth client ID"
    }
  }
}

oauth.clients.list

List the tenant's OAuth clients for mock identity testing.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {}
}

oauth.clients.rotate_secret

Rotate an OAuth client's secret. The new plaintext secret is returned once.

Argument	Type	Description
clientId*	string	Public OAuth client ID

Input schema (JSON)

{
  "type": "object",
  "required": [
    "clientId"
  ],
  "properties": {
    "clientId": {
      "type": "string",
      "description": "Public OAuth client ID"
    }
  }
}

team.invitations.create

Create a team invitation for an email address (SMTP invite is sent by the team service).

Argument	Type	Description
email*	string	Invitee email address

Input schema (JSON)

{
  "type": "object",
  "required": [
    "email"
  ],
  "properties": {
    "email": {
      "type": "string",
      "description": "Invitee email address"
    }
  }
}

team.invitations.delete

Revoke a team invitation.

destructive

Argument	Type	Description
invitationId*	string	Invitation ID

Input schema (JSON)

{
  "type": "object",
  "required": [
    "invitationId"
  ],
  "properties": {
    "invitationId": {
      "type": "string",
      "description": "Invitation ID"
    }
  }
}

team.invitations.list

List the tenant's team invitations.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {}
}

team.members.add

Add a team member directly (no invitation flow).

Argument	Type	Description
email*	string	Member email address
status*	string	Member status, conventionally ACTIVE
user_id*	string	Member user ID
username*	string	Member username

Input schema (JSON)

{
  "type": "object",
  "required": [
    "user_id",
    "username",
    "email",
    "status"
  ],
  "properties": {
    "email": {
      "type": "string",
      "description": "Member email address"
    },
    "status": {
      "type": "string",
      "description": "Member status, conventionally ACTIVE"
    },
    "user_id": {
      "type": "string",
      "description": "Member user ID"
    },
    "username": {
      "type": "string",
      "description": "Member username"
    }
  }
}

team.members.delete

Remove a team member.

destructive

Argument	Type	Description
memberId*	string	Member ID

Input schema (JSON)

{
  "type": "object",
  "required": [
    "memberId"
  ],
  "properties": {
    "memberId": {
      "type": "string",
      "description": "Member ID"
    }
  }
}

team.members.get

Fetch a single team member by ID.

read-only

Argument	Type	Description
memberId*	string	Member ID

Input schema (JSON)

{
  "type": "object",
  "required": [
    "memberId"
  ],
  "properties": {
    "memberId": {
      "type": "string",
      "description": "Member ID"
    }
  }
}

team.members.list

List the tenant's team members.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {}
}