Connect
- Create an API key in the Console — or reuse an identity-scoped key if Cursor should only act as one agent.
-
Add the server in either place:
- Project — create
.cursor/mcp.jsonin the repository - Global — edit
~/.cursor/mcp.json - UI — open Cursor Settings → MCP and add a server, pasting the same values
- Project — create
-
If your Cursor build cannot send custom headers, append the key to the URL instead:
- Cursor detects the change automatically; if the server does not appear, restart Cursor.
Verify
Ask Cursor to callwirebox_whoami. It returns the handle, mailbox address, and iMessage status of the identity the connection acts as.
What Cursor can do
- List, search, read, send, reply to, and delete email in the agent’s mailbox
- List and read iMessage conversations, and send iMessages
- Check which identity the connection acts as
Troubleshooting
See Wirebox MCP Server for the full tool catalog, environment variables, and identity locking.