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

Three ways to write to your workspace

Each interface writes to the same synced workspace.

Start for freeRead the API docs

In the week of 27 July 2026, Linear's 2026 data report counted agents and MCP creating almost as many issues as people did. Done Bear gives that work somewhere to land, on a list you still decide.

Three ways to automate

Command-line interface

For shell scripts, cron jobs, Git hooks, and CI.

Explore the CLI

GraphQL API

For typed reads and writes over HTTP.

Read the GraphQL reference

MCP server

For assistants such as Claude, ChatGPT, and Cursor.

Connect an MCP client

What you can automate

Capture from CI and Git hooks

Set `DONEBEAR_TOKEN` to turn a failed build, deploy, or audit into a synced task.

donebear task add "Dependency audit failed on main" \
  --when today \
  --deadline 2026-08-01 \
  --description "npm audit flagged a high-severity advisory" \
  --json

Call the GraphQL API directly

Use the same key for reads and writes when a shell command is not enough.

curl https://api.donebear.com/graphql \
  -H "Authorization: Bearer $DONEBEAR_TOKEN" \
  -H "Content-Type: application/json" \
  --data '{"query":"query { viewer { id email } }"}'

Frequently asked questions

How do I automate Done Bear?

Create an API key, set it as `DONEBEAR_TOKEN`, and let a script write to your workspace. That is enough to turn a failed build, deploy, or audit into a task. Whatever writes it, the change goes to one synced workspace, so it appears on every device.

How do I get an API key for automation?

Create one with `donebear api-key create "CI"`, then set it as `DONEBEAR_TOKEN` or send it as a bearer token. Revoke it from the CLI anytime.

Can AI agents automate my tasks?

Yes. MCP lets supported assistants read and manage tasks with your permission, using OAuth instead of a pasted API key.

Start for free