CocoInbox Server

Thin MCP wrapper around the existing CocoInbox REST API. Does not modify or rebuild cocoInboxFrontend / cocoInboxBackend.

Tools (v1)

Tool	Maps to
login	POST /api/auth/login + GET /api/auth/me
logout	Clears process session
get_current_user	GET /api/auth/me
auth_status	Local session snapshot
list_emails	GET /api/emails/user/:userId
create_email	POST /api/emails/create
select_email	Picks From address for send
get_email	GET /api/emails/:id/messages
send_email	POST /api/mail/send

Typical flow

1. login({ email, password })
2. list_emails() → pick an id
3. select_email({ emailId }) or create_email({ aliasName })
4. send_email({ to, subject, body })

Setup

cd mcp-server
npm install
cp .env.example .env
# set COCOINBOX_API_URL to your running backend

Cursor (stdio)

Project file .cursor/mcp.json is already configured. Reload MCP in Cursor Settings → Tools & MCP.

HTTP MCP URL (optional)

npm run start:http
# → http://127.0.0.1:3100/mcp

Env

Variable	Default	Meaning
COCOINBOX_API_URL	http://localhost:4000	Existing REST API base
COCOINBOX_TOKEN	—	Optional pre-set Bearer token
MCP_HTTP_PORT	3100	HTTP transport port
# cocoinbox-mcp