# 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 (`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 specification](/openapi.json)

### OpenAPI (YAML)

YAML copy of the same spec.

[OpenAPI (YAML)](/api/openapi.yaml)

### GraphQL API docs

Query workspaces, tasks, projects, teams, labels, and API keys. Mutation payloads return a typed `UserError` list.

[GraphQL API docs](/docs/api)

### API authentication and scopes

Bearer JWTs and `db_` API keys, scoped `read`, `write`, or `admin`.

[API authentication and scopes](/docs/api/authentication)

### auth.md

Agent walkthrough of OAuth, API keys, and JWTs. WorkOS `agent_auth` is not offered.

[auth.md](/auth.md)

### AI catalog

Agentic Resource Discovery catalog of the hosted MCP server, OpenAPI spec, and agent skill.

[AI catalog](/.well-known/ai-catalog.json)

### API versioning policy

The `Api-Version` header, the `Deprecation` and `Sunset` headers a retiring endpoint carries, `@deprecated` GraphQL fields, and how long either lasts.

[API versioning policy](/docs/api/versioning)

### 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 MCP server](/docs/mcp)

### Done Bear CLI

Official CLI published as `donebear` on npm. Install with `npm install -g donebear`, then `donebear auth login`.

[Done Bear CLI](/docs/cli)

### llms.txt

Agent index of docs, pages, comparisons, and optional files.

[llms.txt](/llms.txt)

---

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.