Mimecast MCP
MCP server for Mimecast Email Security — message tracking, threat intelligence search, and held-message queue management.
🔗 Companion Plugin
Pair this MCP server with the Mimecast plugin for skills, commands, and API knowledge alongside direct API access.
Installation
Run the MCP server with npx:
npx @wyre-technology/mimecast-mcp Or install the package:
npm install @wyre-technology/mimecast-mcp MCPB Bundle (Claude Desktop)
Download the .mcpb bundle from
GitHub Releases
for a zero-config Claude Desktop install. No Node.js or terminal required — just open the
bundle in Claude Desktop via Settings → MCP Servers → Install from file.
Requires Claude Desktop 0.10+.
Claude Desktop Configuration
Add to your claude_desktop_config.json:
{
"mcpServers": {
"mimecast": {
"command": "npx",
"args": [
"@wyre-technology/mimecast-mcp"
],
"env": {
"MIMECAST_CLIENT_ID": "your-mimecast-client-id",
"MIMECAST_CLIENT_SECRET": "your-mimecast-client-secret",
"MIMECAST_REGION": "your-mimecast-region"
}
}
}
} Authentication
| Variable | Required | Description |
|---|---|---|
MIMECAST_CLIENT_ID | Yes | Mimecast API 2.0 client ID |
MIMECAST_CLIENT_SECRET | Yes | Mimecast API 2.0 client secret |
MIMECAST_REGION | Yes | Mimecast region: us | eu | de | za | au | jer | offshore |
Getting Credentials
⚠️ Portal verification pending
The instructions below are our best understanding of the vendor's credential-acquisition flow but have not been verified hands-on against the current portal. If you hit a step that doesn't match what you see, please let us know — we'll update the docs.
Vendor portal: https://www.mimecast.com/
Prerequisites
- Mimecast administration portal access
- Mimecast API 2.0 enabled on your account
Steps
- Sign in to your Mimecast Administration Console.
- Navigate to Services → API Integrations.
- Create a new API 2.0 integration; save Client ID and Client Secret.
- Set MIMECAST_CLIENT_ID, MIMECAST_CLIENT_SECRET, and MIMECAST_REGION (us, eu, de, za, au, jer, or offshore per your deployment).
Architecture
Single TypeScript MCP server using Mimecast API 2.0 OAuth client credentials, supporting all Mimecast cloud regions.
Available Tools (7)
Tools are organized into 3 domains:
Messages
Search and trace email messages flowing through Mimecast.
| Tool | Description |
|---|---|
mimecast_messages_search | Search messages by sender / recipient / subject / time range |
mimecast_messages_trace | Trace a specific message through the Mimecast pipeline |
Threats
Threat intelligence and URL / attachment detections.
| Tool | Description |
|---|---|
mimecast_threats_list | List detected threats with filters |
mimecast_threats_get | Get full threat record by ID |
Queue
Held / quarantined message queue management.
| Tool | Description |
|---|---|
mimecast_queue_list | List held / quarantined messages |
mimecast_queue_release | Release a held message to its recipient |
mimecast_queue_reject | Reject a held message |