API & MCP documentation

Everything in the dashboard, available programmatically.

Overview

Mesita is a Trello-style Kanban app. Everything you can do in the dashboard is also available through the REST API and the MCP server — they call the same endpoints, so they never drift.

• REST base URL: https://dash.mesita.io/api/v1
• MCP endpoint: https://dash.mesita.io/mcp

Authentication

All API and MCP requests use a bearer key. Create one in the dashboard under API & MCP.

• Workspace key — scoped to one workspace. Pass it as Authorization: Bearer <key>.
• Account key — spans every workspace you belong to. Pass the target workspace per request with the X-Mesita-Workspace: <slug-or-id> header (REST) or a workspace argument (MCP). If you only have one workspace it is selected automatically.

The dashboard UI itself uses the same API with a session cookie + X-CSRF-Token.

Connect to Claude / ChatGPT (MCP)

Add Mesita as a custom MCP connector:

1. URL: https://dash.mesita.io/mcp
2. Authenticate with a workspace or account API key (Bearer token).
3. The server exposes ~85 tools covering boards, lists, cards, labels, members, dates, checklists, comments, attachments, custom fields, search, automation, webhooks and bulk operations.

The MCP protocol is JSON-RPC 2.0 over HTTP POST (initialize, tools/list, tools/call).

Boards

• GET /boards — list boards
• POST /boards — create {name, description?, visibility?, background?, with_default_lists?}
• GET /boards/{id} — full board (lists + cards + labels + members + fields)
• PATCH /boards/{id} — {name?, description?, background?, bg_type?, visibility?}
• DELETE /boards/{id}
• POST /boards/{id}/star · POST /boards/{id}/archive ({reopen:true} to reopen)
• POST /boards/{id}/copy · GET /boards/{id}/export
• POST /boards/{id}/members {user, role} · DELETE /boards/{id}/members/{uid}

Lists

• GET /boards/{id}/lists · POST /boards/{id}/lists {name, position?}
• PATCH /lists/{id} {name?, wip_limit?, collapsed?, position?}
• DELETE /lists/{id} · POST /lists/{id}/archive · POST /lists/{id}/move {board_id?, position?}
• POST /lists/{id}/sort {by: due|created|votes|alpha}
• GET /lists/{id}/cards · POST /lists/{id}/cards {title, description?}

Cards

• GET /cards/{id} — full card · PATCH /cards/{id} {title?, description?, cover_type?, cover_value?, start_at?, due_at?, due_reminder?}
• DELETE /cards/{id} · POST /cards/{id}/move {list_id, position?} · POST /cards/{id}/copy {list_id, linked?}
• POST /cards/{id}/archive · POST /cards/{id}/vote · POST /cards/{id}/watch / DELETE …/watch
• POST /cards/{id}/complete ({undo:1} to undo)
• Labels: POST /cards/{id}/labels {label_id} · DELETE /cards/{id}/labels/{label_id}
• Members: POST /cards/{id}/members {user_id} · DELETE /cards/{id}/members/{user_id}
• Comments: GET /cards/{id}/comments · POST /cards/{id}/comments {body} (Markdown, @email mentions)
• Attachments: GET/POST /cards/{id}/attachments {kind, url, name}
• Checklists: POST /cards/{id}/checklists {name} · Field value: POST /cards/{id}/fields {field_id, value}

Labels, fields, checklists

• GET/POST /boards/{id}/labels {name, color} · PATCH/DELETE /labels/{id}
• GET/POST /boards/{id}/fields {name, type, options?} · PATCH/DELETE /fields/{id}
• POST /checklists/{id}/items {text} · PATCH/DELETE /checklist-items/{id} · POST /checklist-items/{id}/convert
• PATCH/DELETE /comments/{id} · POST /comments/{id}/reactions {emoji} · DELETE /attachments/{id}

Search, automation, webhooks

• GET /search?q= · POST /filter {q?, board_id?, list_id?, label_id?, member_id?, overdue?, due_before?}
• GET/POST /filters (saved filters)
• GET/POST /boards/{id}/rules · PATCH/DELETE /rules/{id} · POST /rules/{id}/run {card_id}
• GET/POST /webhooks {url, board_id?, events?} · PATCH/DELETE /webhooks/{id} (deliveries are HMAC-signed with X-Mesita-Signature)
• POST /import {json, name?} — import a Trello board export
• Notifications: GET /notifications · POST /notifications/{id}/read
• Bulk: POST /bulk/move · POST /bulk/archive · POST /bulk/label

Example

Create a board with lists and a card:

curl -X POST https://dash.mesita.io/api/v1/boards \
  -H 'Authorization: Bearer YOUR_KEY' -H 'Content-Type: application/json' \
  -d '{"name":"Roadmap","with_default_lists":true}'

curl -X POST https://dash.mesita.io/api/v1/lists/123/cards \
  -H 'Authorization: Bearer YOUR_KEY' -H 'Content-Type: application/json' \
  -d '{"title":"Ship v1","description":"**Markdown** supported"}'