@donebear/mcp

MCP server for Done Bear. Connects AI coding assistants to your tasks, projects, labels, and teams.

Prerequisites

• Node.js 18 or newer
• A Done Bear account

Quick start

1. Install the CLI and sign in

npm install -g donebear
donebear auth login

2. Create an API key

donebear api-key create mcp

Copy the key that starts with db_.

3. Add the MCP server to your client

Pick your client below and paste the config. Replace <your-token> with the key from step 2.

Setup

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "donebear": {
      "command": "npx",
      "args": ["-y", "@donebear/mcp"],
      "env": {
        "DONEBEAR_TOKEN": "<your-token>"
      }
    }
  }
}

Claude Code

claude mcp add donebear -e DONEBEAR_TOKEN=<your-token> -- npx -y @donebear/mcp

Then run /mcp in a Claude Code session to verify the connection.

Cursor

Add to .cursor/mcp.json in your project or ~/.cursor/mcp.json globally:

{
  "mcpServers": {
    "donebear": {
      "command": "npx",
      "args": ["-y", "@donebear/mcp"],
      "env": {
        "DONEBEAR_TOKEN": "<your-token>"
      }
    }
  }
}

VS Code (Copilot)

Add to .vscode/mcp.json in your project:

{
  "mcpServers": {
    "donebear": {
      "command": "npx",
      "args": ["-y", "@donebear/mcp"],
      "env": {
        "DONEBEAR_TOKEN": "<your-token>"
      }
    }
  }
}

Windsurf

Open Windsurf settings (Ctrl/Cmd + ,), scroll to Cascade > MCP servers, select Add custom server, and add:

{
  "mcpServers": {
    "donebear": {
      "command": "npx",
      "args": ["-y", "@donebear/mcp"],
      "env": {
        "DONEBEAR_TOKEN": "<your-token>"
      }
    }
  }
}

Zed

Open Zed settings (Cmd + ,) and add:

{
  "context_servers": {
    "donebear": {
      "command": {
        "path": "npx",
        "args": ["-y", "@donebear/mcp"],
        "env": {
          "DONEBEAR_TOKEN": "<your-token>"
        }
      }
    }
  }
}

Codex

codex mcp add donebear -- npx -y @donebear/mcp

Others

Any MCP client that supports stdio servers can use these settings:

• Command: npx
• Arguments: -y @donebear/mcp
• Environment: DONEBEAR_TOKEN=<your-token>

Authentication

The MCP server resolves a token in this order:

1. DONEBEAR_TOKEN environment variable (recommended for MCP)
2. Stored CLI session at ~/.config/donebear/auth.json (auto-refreshes)

If you have the CLI installed and logged in, the MCP server works without setting DONEBEAR_TOKEN.

Environment variables

| Variable | Required | Description | | --------------------- | -------- | ------------------------------------------------------- | | DONEBEAR_TOKEN | No | API key or JWT. Recommended for MCP clients. | | DONEBEAR_API_URL | No | API base URL. Defaults to https://api.donebear.com. | | DONEBEAR_CONFIG_DIR | No | Override the config directory for stored auth sessions. |

Available tools

| Tool | Description | Type | | -------------- | --------------------------------------------- | ----- | | get_context | Workspace snapshot: task counts, recent tasks | Read | | task_list | List tasks filtered by view, state, or search | Read | | task_show | Get task details and checklist items | Read | | task_add | Create a new task | Write | | task_edit | Update task fields | Write | | task_done | Mark a task as complete | Write | | task_reopen | Reopen a completed task | Write | | task_archive | Archive a task | Write | | project_list | List projects by status | Read | | project_add | Create a new project | Write | | search | Search tasks by title or description | Read | | label_list | List workspace labels | Read | | team_list | List workspace teams | Read |

Troubleshooting

"Not authenticated" Set DONEBEAR_TOKEN in your MCP config or run donebear auth login from the CLI.

Server not appearing in client Verify the config file path, restart the client, and check that npx @donebear/mcp runs without errors in your terminal.

"Multiple workspaces found" Pass the workspace parameter to tools or set a default workspace via donebear workspace use <name>.

Stale npx cache Run npx @donebear/mcp@latest to force the latest version.

Windows: command not found Use npx.cmd instead of npx as the command in your config.