Mursa MCP

Connect Claude Code, Claude Desktop, Cursor, or any MCP-compatible client to your Mursa tasks, calendar, goals, notes, habits, projects, and Gmail.

📖 Full guide with screenshots: https://mursa.me/mcp

---

60-second install

1. Get an API key

1. Open dashboard.mursa.me and sign in.
2. Go to Settings → API keys.
3. Click New key → pick a label, expiry, and scopes → Create.
4. Copy the key (starts with mursa_mcp_…). You'll only see it once.

2. Add to your client

Claude Code (~/.claude.json)

{
  "mcpServers": {
    "mursa": {
      "command": "npx",
      "args": ["-y", "mursa-mcp"],
      "env": { "MURSA_API_KEY": "mursa_mcp_…" }
    }
  }
}

Restart Claude Code, run /mcp to confirm, call whoami to verify.

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%/Claude/claude_desktop_config.json (Windows) with the same block, then restart the app.

Cursor

Settings → MCP → Add new MCP server, same JSON block.

3. That's it

Your agent now has access to whatever scopes your key has.

---

Tools (28)

Group	Tools	Scope
Meta	whoami	(any)
Tasks (read)	list_inbox, list_myday, list_schedule, search_tasks	tasks:read
Tasks (write)	create_task, update_task, complete_task, defer_task, schedule_task	tasks:write
Calendar	list_calendar, create_calendar_event	calendar:*
Goals	list_goals, create_goal, update_goal, delete_goal	goals:*
Notes	list_notes, search_notes, create_note, update_note	notes:*
Habits	list_habits	habits:read
Projects	list_projects	projects:read
Email	list_emails, get_email, get_attachment, search_emails	email:read
Email	send_email, reply_email	email:send

* as a scope grants everything.

---

Security

• API keys are sha256-hashed at rest — the raw value is never stored.
• Per-key scopes + expiry. Revoke any key instantly from the dashboard.
• Per-action rate limits (60/min reads, 30/min writes, 5/min email send).
• Every call audit-logged for 90 days (action, status, latency, IP — no payload).
• Email attachments capped at 3 MB each / 10 MB total per email.
• All traffic goes through mursa.me/api/mcp; the Supabase function is gated by a shared proxy secret so direct hits return 403.

---

Run from source (advanced)

git clone https://github.com/Murali1889/Prod-Mursa.git
cd Prod-Mursa/mcp-servers/mursa
npm install
echo 'MURSA_API_KEY=mursa_mcp_…' > .env

Then point your client at the absolute path:

{
  "mcpServers": {
    "mursa": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-servers/mursa/server.js"]
    }
  }
}

Override the endpoint for preview deployments or local dev:

MURSA_API_URL=https://mursa-preview.vercel.app/api/mcp

(Default is https://mursa.me/api/mcp.)

---

Troubleshooting

Symptom	Fix
Invalid, expired, or revoked API key	Mint a fresh key in the dashboard, swap MURSA_API_KEY, restart your client.
This API key is missing the required scope: …	Your key wasn't granted that scope at mint time. Revoke and mint a new one with the scope checked.
Gmail is not connected. Connect Gmail in Mursa Settings first.	Connect Gmail from the Mursa app first.
Rate limit exceeded (5/min for send_email)	Slow down — strict throttle on outbound mail.

For server-side deployment (running your own Mursa instance), see DEPLOY.md.