devBoard

devBoard MCP server

devBoard is a simple project tracker for freelancers and small dev teams: boards, epics, releases and a timer, in an app for iPhone, Android and Mac. This is its MCP server. Connect it once and your AI assistant can read the task it is working on, open new ones, comment, move cards and track your time. It acts as you, in one workspace, with your role.

• Server: https://api.getdevboard.app/mcp (Streamable HTTP)
• Auth: Authorization: Bearer <token>; make the token in the Mac app under Settings → Developer
• Setup page with every client: https://getdevboard.app/mcp
• Website: https://getdevboard.app

Quick start

Claude Code:

claude mcp add --transport http --scope user devboard https://api.getdevboard.app/mcp \
  --header "Authorization: Bearer <your-token>"

Cursor (~/.cursor/mcp.json):

{
  "mcpServers": {
    "devboard": {
      "url": "https://api.getdevboard.app/mcp",
      "headers": { "Authorization": "Bearer <your-token>" }
    }
  }
}

VS Code (.vscode/mcp.json, asks for the token once and keeps it out of the file):

{
  "inputs": [
    { "type": "promptString", "id": "devboard-token", "description": "devBoard token", "password": true }
  ],
  "servers": {
    "devboard": {
      "type": "http",
      "url": "https://api.getdevboard.app/mcp",
      "headers": { "Authorization": "Bearer ${input:devboard-token}" }
    }
  }
}

Claude Desktop goes through mcp-remote; the exact block is on https://getdevboard.app/mcp.

Then ask: "What's on my plate today?" or "Start APP-42."

Tools (29)

Area	Tools
Find and read	get_workspace, search_items, get_item, my_work, run_view
Tickets	create_item, update_item, move_item, archive_item
Comments	add_comment, edit_comment, delete_comment
Dev loop	start_work (assigns you, moves the card to In progress, starts the timer, returns a branch name), finish_work (stops the timer, comments, moves the card)
Time	start_timer, stop_timer, log_time, timesheet, edit_time_entry, delete_time_entry
Personal to-dos	list_todos, add_todo, update_todo, delete_todo
Inbox	list_notifications, mark_notifications_read
Admin only	create_release, ship_release, create_label

It cannot delete items, change workspace settings, or manage members and invites. Those stay in the app.

Safety

• A token acts as you, with your role. A member's token can do what a member can do and nothing more.
• A token belongs to one workspace, the one that was open when you made it. Several clients means several tokens.
• Revoke a token in Settings → Developer and it stops working at once. devBoard stores only a hash of it.
• Guests can read a workspace but cannot create tokens.

More: https://getdevboard.app/guides/mcp-token-security

REST without MCP

The same token works on a small REST API at https://api.getdevboard.app/dev/v1: GET me, GET projects, GET items?project=&q=, GET items/{KEY}, GET items/{KEY}/pulls, POST items/{KEY}/status. Guide: https://getdevboard.app/guides/rest-api-from-ci

Pull requests from GitHub

A pull request that mentions an item key (APP-42) in its title, body or branch shows on that item and can move the card when it opens, merges or closes. One webhook per repository: https://getdevboard.app/guides/link-github-pull-requests

As a plugin

This repository is also an Agent Plugins package (plugin.json + mcp.json), so plugin directories such as cursor.directory can import it. The plugin file lists the server URL only. Plugins must not carry secrets, so after installing it add your own token as an Authorization: Bearer <token> header in your client, as shown above.

Where it is listed

• Official MCP Registry as app.getdevboard/devboard
• Smithery

About this repository

This repository holds the registry listing (server.json) and documentation for the hosted server. The server itself is part of the devBoard backend and is not open source. Questions: [email protected]