Done Bear MCP

Manage tasks, projects, areas and tags in Done Bear from MCP-compatible AI clients.

Community: Submitted by a user or imported; check the owner before granting accessOnlineNo sign-inGlobalFreeCan modify data

What it can do

  • Guide: Read Done Bear's guide for one topic: what the data means, how it relates to the rest of the product, and how to use it well. Load a topic before doing that kind of work for the first time in a
  • Get Context: Get a snapshot of the current workspace: user info, task counts, recent tasks, and active projects. Call this first to orient yourself before taking actions.
  • Task List: List tasks in the workspace, most recently updated first. Filter by view (inbox, today, upcoming, anytime, someday) and/or state (open, done, archived, all); `search` ranks matches within t

What data it sees

Do you need an account

No: the server works without sign-in

Manage tasks, projects, areas and tags in Done Bear from MCP-compatible AI clients. Uses OAuth and supports read and write task workflows.

How to connect

How to connect Done Bear MCP to Claude

The server address to paste into Claude settings:

https://donebear--donebear.run.tools

  1. Open Claude (claude.ai or the desktop app).
  2. Go to Settings → Connectors.
  3. Click Add custom connector.
  4. Paste the server address copied below into Remote MCP server URL and click Add.
  5. In a chat, click + → Connectors and switch the new connector on.

Custom connectors are available on Free, Pro, Max, Team and Enterprise plans (Free is limited to one). On Team and Enterprise an organization Owner adds the connector first under Organization settings → Connectors.

Authorization

After you click Add, a sign-in window for the service opens. Sign in with your own account and approve access. Claude never sees your password.

How to connect Done Bear MCP to ChatGPT

The server address to paste into ChatGPT settings:

https://donebear--donebear.run.tools

  1. Open ChatGPT in a browser (chatgpt.com). A Plus, Pro, Business, Enterprise or Edu plan is required.
  2. Turn on developer mode once: Settings → Apps → Advanced settings → Developer mode.
  3. Open Settings → Connectors and click Create.
  4. Fill in the form: Name (anything), Description (one line about what the service does), MCP server URL (copy it below).
  5. Under Authentication choose OAuth if the service requires sign-in, otherwise None. Click Create.
  6. In a new chat open + → Apps/Connectors and enable the connector.

OpenAI has renamed this section before (Connectors → Apps/Plugins). If the label differs, search settings for "developer mode". On Business/Enterprise workspaces an admin must allow custom connectors first.

Authorization

On first use ChatGPT opens the service's sign-in window. Sign in and approve access.

How to connect Done Bear MCP to Cursor

The server address to paste into Cursor settings:

https://donebear--donebear.run.tools

Fastest: click Open in Cursor below and confirm the prompt.

Manually:

  1. In Cursor open Settings → Cursor Settings → MCP and click Add new global MCP server.
  2. Paste the JSON copied below into ~/.cursor/mcp.json (per project: .cursor/mcp.json in the repo root).
  3. Save the file. The server appears in the MCP list; authorize it there if asked.

Authorization

If the service needs sign-in, an authorize button appears next to the server in the MCP list.

Server tool list (26)

Raw names from tools/list. Only developers need these.

guideRead Done Bear's guide for one topic: what the data means, how it relates to the rest of the product, and how to use it well. Load a topic before doing that kind of work for the first time in a session. - `views`: Placing a task in Inbox/Today/Upcoming/Anytime/Someday, reading a view, or working out why Today looks wrong. - `dates`: Setting or clearing a due date, or deciding between a deadline and a start date. - `editing`: Changing a task's fields, clearing a value, appending to notes, or moving a task between projects. - `bulk`: Completing, moving, or editing more than one task at a time, or sweeping a whole view. - `checklists`: Adding sub-steps to a task, building a list inside a task, or ticking items off. - `projects`: Deciding where a task belongs, creating a project or label, or changing a project's status. - `search`: Looking a task up, listing a view, paging through results, or orienting in a new workspace. - `workspaces`: Working across multiple workspaces, hitting a permission or rate-limit error, or making retries safe. - `agents`: Starting work in a Done Bear workspace for the first time.
get_contextGet a snapshot of the current workspace: user info, task counts, recent tasks, and active projects. Call this first to orient yourself before taking actions.
task_listList tasks in the workspace, most recently updated first. Filter by view (inbox, today, upcoming, anytime, someday) and/or state (open, done, archived, all); `search` ranks matches within that filter. Returns up to `limit` tasks; `hasMore` is true when more matched than were returned.
task_showGet full details for a single task including its labels and checklist items. Pass its workspace-scoped task number.
task_addCreate a new task. The `when` parameter controls which GTD view it appears in: inbox (default), today, upcoming, anytime, or someday. Dates use YYYY-MM-DD format. Optionally set an assignee, attach labels, and create checklist items at creation. For a task with sub-items (e.g. a shopping list), pass them in `checklist` in one call: their order is preserved exactly.
task_editUpdate one or more fields on an existing task. Only the provided fields are changed; omitted fields are left untouched. To remove a value, list the field in `clear` (e.g. `clear: ["deadline"]`). Notes replace the existing notes (no append). Use label_add/label_remove to change labels.
task_doneMark a task as complete. It moves to the Logbook view.
task_reopenReopen a completed task. It returns to its previous view.
task_archiveArchive a task. It moves to the Trash view.
project_listList projects in the workspace. Filter by status: active (default), done, archived, or all. Returns up to `limit` projects; `hasMore` is true when more matched than were returned.
project_addCreate a new project in the workspace.
searchSearch tasks across the workspace. Ranked lexical search over title and description: exact and prefix matches rank first, then word-boundary, substring, and fuzzy matches, with recency and status factored in. Multi-word queries match in any order.
label_listList labels in the workspace. Returns up to `limit` labels; `hasMore` is true when more matched than were returned.
team_listList active (non-archived) teams in the workspace. Returns up to `limit` teams; `hasMore` is true when more matched than were returned.
checklist_listList the checklist items on a task in display order, including each item's id and completion state.
checklist_addAdd checklist items to a task; items start unchecked and append after existing ones. Pass `title` for one item or `titles` for several: a `titles` batch keeps the given order, so ALWAYS add a multi-item list in one call rather than one call per item (parallel single adds land in arrival order, not list order).
checklist_doneMark a checklist item as complete. To uncheck it again, use checklist_edit with completed: false.
checklist_editUpdate a checklist item: rename it and/or set its completion state. Only the provided fields are changed; pass completed: false to uncheck an item.
checklist_removeRemove a checklist item from a task.
label_createCreate a new label in the workspace.
label_addAdd a label to a task.
label_removeRemove a label from a task.
task_bulk_editUpdate multiple tasks at once (max 50 numbers per call). Only the provided fields in `changes` are applied to all specified tasks; list fields in `changes.clear` to remove their values. Confirm the number list with the user first: one call rewrites every task in it, and there is no undo.
task_bulk_doneMark multiple tasks as complete at once (max 50 task numbers per call).
task_assignAssign a task to a workspace member, or unassign by passing an empty string.
project_editUpdate one or more fields on an existing project. Only the provided fields are changed.