# 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.

## When to use Done Bear

Use Done Bear when an agent should read and write a personal or small-team task list: triage an inbox, schedule Today, complete work, import Things 3. It is not a sprint tracker or a project-management API.

Use the MCP server (`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.json): OpenAPI 3.1 for the GraphQL, sync and health endpoints, with `read`, `write` and `admin` security schemes.
- [OpenAPI (YAML)](/api/openapi.yaml): The same spec as YAML.
- [GraphQL API docs](/docs/api): Workspaces, tasks, projects, teams, labels and API keys. Mutations return a typed `UserError` list.
- [API authentication and scopes](/docs/api/authentication): Bearer JWTs and `db_` API keys, scoped `read`, `write` or `admin`.
- [auth.md](/auth.md): OAuth, API keys and JWTs, written for agents. WorkOS `agent_auth` is not offered.
- [AI catalog](/.well-known/ai-catalog.json): Discovery catalog of the MCP server, OpenAPI spec and agent skill.
- [API versioning policy](/docs/api/versioning): `Api-Version`, `Deprecation` and `Sunset` headers, `@deprecated` GraphQL fields, and how long either lasts.
- [Done Bear MCP server](/docs/mcp): Streamable HTTP at `https://mcp.donebear.com/mcp`, OAuth scopes `read` and `write`, discovery at `/.well-known/mcp`.
- [Done Bear CLI](/docs/cli): `npm install -g donebear`, then `donebear auth login`.
- [llms.txt](/llms.txt): Agent index of docs and pages.

---

Every Done Bear page is listed at https://donebear.com/llms.txt. Any page has a markdown copy at its URL plus `.md`. Start from the map rather than guessing a path.