@mytaskboard/mcp-server

Connect Cursor, Claude Desktop, or any MCP client to one myTaskBoard board. The server uses your Board API Key (mbk_…) and the Integration HTTP API.

Version 0.2.1 — 44 tools + 4 workflow prompts; mixed Markdown/HTML task descriptions in tool docs.

Requirements

• Node.js 20+ (for npx)
• A Board API Key created in the web app: board → settings → API keys
  Scopes: tasks:read, tasks:write, comments:read, comments:write
• Your backend HTTPS URL (no trailing slash)

Setup

Option A — copy from the web UI (recommended)

1. Open board settings → API keys → section AI (MCP).
2. Click Copy config.
3. Paste into your MCP client config and replace the API key if needed.
4. Restart the MCP client.

Option B — manual mcp.json

{
  "mcpServers": {
    "mytaskboard": {
      "command": "npx",
      "args": ["-y", "@mytaskboard/[email protected]"],
      "env": {
        "MYTASKBOARD_API_URL": "https://your-backend.example.com",
        "MYTASKBOARD_BOARD_ID": "your-board-id",
        "MYTASKBOARD_API_KEY": "mbk_..."
      }
    }
  }
}

Environment variables

| Variable | Required | Description | |----------|----------|-------------| | MYTASKBOARD_API_URL | yes | Backend base URL (origin only) | | MYTASKBOARD_BOARD_ID | yes | Board id from the UI | | MYTASKBOARD_API_KEY | yes | Board API Key secret (mbk_…) | | MYTASKBOARD_MCP_DEBUG | no | 1 — diagnostic logs on stderr | | MYTASKBOARD_TLS_INSECURE | no | 1 — dev/staging only: skip TLS verify |

Tools and prompts

43 tools covering board setup, tasks, subtasks, comments, sprints, reminders, and canvas widgets.

4 prompts: create_task_workflow, sprint_planning, canvas_relations, reminder_setup.

Full reference: docs/TOOLS.md.

Developers: tests and npm publish — docs/mcp/RELEASE.md.

Troubleshooting

| Problem | What to check | |---------|----------------| | Auth / 401 | Key correct; prefix mbk_ | | 403 Forbidden | Recreate key in UI | | Cannot create task | board_columns_list or column_create | | Sprints fail | Sprints must be enabled on the board | | Canvas empty | Set descriptionMode: "canvas" via task_update | | Tools missing | Restart MCP client after config change |

License

MIT