Get started
Limits
How much mail syncs, page sizes, and rate limits.
Sync window
- iCloud, IMAP, and Microsoft keep the newest ~300 messages per selected folder. Gmail syncs ~40 per label each time and fills in to ~300 over its first syncs.
- Default folders are Inbox, Sent, and Drafts. Spam and Trash are never synced or searched.
- Loading older mail stops at 1000 messages per folder.
- A sync that finished less than a minute ago is skipped. Syncing in a loop gains nothing.
Page sizes
- List pages: default 50, max 200.
- Provider search: default 20, max 50.
- Gmail label, star, and archive changes: 25 messages per call.
- Request bodies: 100 KB.
Rate limits
/api: 120 requests per minute per API key./mcp: 300 requests per minute per API key or connected agent.- Short bursts are fine. Each credential can send up to a minute's worth at once, then one more as each share of the minute passes.
- Requests with no credential, and credentials that fail, are limited by client address at the same rate.
- Over the limit you get 429 with
Retry-Afterin seconds. On/apithe body israte_limitedin the usual error shape. On/mcpit is a JSON-RPC error. - Sign-in and OAuth endpoints allow 60 requests per minute per client address.
- Providers have their own quotas, and Gmail may slow a sync down.
Time limits
- Triage lease: 8 minutes, extended by each heartbeat.
- Pending sends expire after 2 hours. Pending unsubscribes after 15 minutes.
- Attachment links work for about 15 minutes.