Ainoflow LogoAinoflow
← Back to MCP Documentation

Inbox MCP API

Email receiving and processing for AI agents via Model Context Protocol

Overview

The Inbox MCP API provides AI assistants with email inbox access capabilities. Agents can list email messages, mark them as handled, download attachments, and delete processed messages using the MCP protocol over HTTP transport with JSON-RPC 2.0.

MCP Endpoint

https://mcp.ainoflow.io/mcp/v1/inbox

Transport:

HTTP (SSE)

Configuration

OpenAI Agent Builder

Add MCP server in the UI dialog:

URL:
Label:
Authentication (Access token / API Key):
Claude Desktop

Add to your Claude Desktop configuration:

Cursor IDE

Add to your Cursor MCP configuration:

Available Tools

inbox_messages
List email messages from an inbox with full text content and attachment metadata
email
required
- Inbox hook email address
isHandled
optional
- Filter: true = handled only, false = unhandled only, omit = all
fromAddress
optional
- Filter by sender (case-insensitive, partial match)
receivedAfter
optional
- Filter messages after date (ISO 8601)
receivedBefore
optional
- Filter messages before date (ISO 8601)
sortBy
optional
- ReceivedAt (default), FromAddress, Subject, SizeBytes
sortOrder
optional
- Asc, Desc (default)
page
optional
- Page number (1-based)
limit
optional
- Items per page (default: 50)

Example Usage:

Response:

inbox_attachment_url
Get a pre-signed download URL for an email attachment. Valid for 1 hour.
attachmentId
required
- Attachment identifier from inbox_messages response

Example Usage:

Response:

inbox_handle_message
Mark a message as handled and return its full content. Idempotent - calling on an already-handled message returns it successfully.
messageId
required
- Message identifier from inbox_messages response

Example Usage:

Response:

inbox_delete_message
Delete an email message and its attachments permanently.
messageId
required
- Message identifier from inbox_messages response

Example Usage:

Response:

Available Resources

inbox://list
List all inboxes with name, email address, status, and message counts

MIME Type: application/json

Returns: [{"name": "Support Inbox", "email": "habcd1234-...@ainobox.com", "status": "active", "messageCount": 42}]

Use Cases for AI Assistants

Invoice Email Processing

Process invoices received by email

Order Intake

Parse incoming order emails

Document Collection

Gather documents from external senders

Inbox Discovery

Discover and monitor inboxes

Constraints and Limits
Key specifications for Inbox MCP operations
Max email size10 MB (10485760 bytes)
Max attachments10 per email
Default TTL30 days
DeduplicationSHA-256 hash of raw email
Download URL expiry1 hour (default)
List page sizeDefault 50, max 5000
REST API Compatibility
Both MCP and REST APIs can be used simultaneously
REST APIMCP Tool
GET /inbox/{id}/messagesinbox_messages
GET /inbox/.../attachments/{id}/urlinbox_attachment_url
POST /inbox/{id}/messages/{msgId}/handleinbox_handle_message
DELETE /inbox/{id}/messages/{msgId}inbox_delete_message
View full REST API Documentation →

Ready to integrate Inbox MCP?

Sign up for free and start processing emails with your AI agents

Get Started Free Back to MCP Hub