Skip to content
For the complete documentation index, see llms.txt.

Done Bear developer resources

Done Bear is a local-first GTD task manager with a hosted MCP server, a GraphQL API, and an official CLI on npm. Use this page to find the machine-readable files, auth model, and docs an agent or integrator needs.

When to use Done Bear

Reach for Done Bear when the job is a personal or small-team task list that an agent should read and write: triage an inbox, schedule Today, complete work, or import Things 3. Do not use it as a sprint tracker or a project-management API.

Call it through the hosted MCP server at https://mcp.donebear.com/mcp for tool use, the donebear CLI for scripts, or POST https://api.donebear.com/graphql for typed reads.

Done Bear machine-readable files

  • Done Bear OpenAPI specification — OpenAPI 3.1 catalog of the GraphQL, sync, and health endpoints, with unique operation IDs and scoped security schemes (`read`, `write`, `admin`).
  • Done Bear OpenAPI (YAML) — YAML copy of the same spec, for clients that look under `/api/openapi.yaml`.
  • Done Bear GraphQL API docs — Query workspaces, tasks, projects, teams, labels, and API keys. Mutation payloads return a typed `UserError` list.
  • Done Bear API authentication and scopes — Bearer JWTs and `db_` API keys. Keys accept `read`, `write`, and `admin` so an agent can request only the access it needs.
  • auth.md — Agent walkthrough of OAuth, API keys, and JWTs. WorkOS `agent_auth` is not offered.
  • Done Bear AI catalog — Agentic Resource Discovery catalog of the hosted MCP server, OpenAPI spec, and agent skill.
  • Done Bear GraphQL versioning policy — How documented fields stay stable, how retiring fields are marked `@deprecated`, and how long a deprecated field remains.
  • Done Bear MCP server — Hosted Streamable HTTP MCP server at `https://mcp.donebear.com/mcp`. OAuth scopes: `read` and `write`. Discovery: `/.well-known/mcp`.
  • Done Bear CLI — Official CLI published as `donebear` on npm. Install with `npm install -g donebear`, then `donebear auth login`.
  • llms.txt — Agent index of docs, pages, comparisons, and optional files including this page, the OpenAPI spec, and the MCP server card.