Done Bear developer resources

Done Bear is a local-first GTD task manager you can reach through a GraphQL API, an official CLI on npm and a hosted MCP server. Here is what an integrator needs: the OpenAPI spec, the auth model and scopes, the API versioning policy, the agent discovery files and the docs for each interface.

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 and writes.

Resources

OpenAPI specification: OpenAPI 3.1 catalog of the GraphQL, sync, and health endpoints, with unique operation IDs and scoped security schemes (`read`, `write`, `admin`).
OpenAPI (YAML): YAML copy of the same spec.
GraphQL API docs: Query workspaces, tasks, projects, teams, labels, and API keys. Mutation payloads return a typed `UserError` list.
API authentication and scopes: Bearer JWTs and `db_` API keys, scoped `read`, `write`, or `admin`.
auth.md: Agent walkthrough of OAuth, API keys, and JWTs. WorkOS `agent_auth` is not offered.
AI catalog: Agentic Resource Discovery catalog of the hosted MCP server, OpenAPI spec, and agent skill.
API versioning policy: The `Api-Version` header, the `Deprecation` and `Sunset` headers a retiring endpoint carries, `@deprecated` GraphQL fields, and how long either lasts.
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.