# AI onboarding

> Everything an AI agent needs to use Done Bear.

Done Bear is a local-first GTD list. Agents read and write the same Inbox and Today a human uses. Prefer the hosted MCP server. Use the CLI skill when MCP is not available.

This page points at those surfaces. It does not replace the full guides.

## Prerequisite

A human creates the account and signs in once, in the app or with `donebear auth login`. After that, agents use MCP OAuth or a `DONEBEAR_TOKEN` / API key. There is no agent-only signup.

## Hosted MCP

Endpoint:

```text
https://mcp.donebear.com/mcp
```

Handshake:

```text
https://donebear.com/.well-known/mcp
```

OAuth scopes: `read` and `write`.

**Claude Code**

```bash
claude mcp add --transport http donebear https://mcp.donebear.com/mcp
```

**Codex**

```bash
codex mcp add donebear --url https://mcp.donebear.com/mcp
```

See [MCP overview](/mcp) and [Get started with MCP](/mcp/get-started) for other clients, OAuth, and troubleshooting.

## Agent skills

```bash
npx skills add donebear/skills -g --all -y
```

Discovery:

```text
https://donebear.com/.well-known/agent-skills/index.json
https://donebear.com/skill.md
```

See [Skills](/skills). Skills teach the CLI; MCP is the cleaner remote integration when the client supports it.

## CLI

```bash
npm install -g donebear
```

Prefer `--json`. For non-interactive runs, set `DONEBEAR_TOKEN` instead of a browser login.

See [CLI overview](/cli) and [Automate with tokens, JSON, and context](/cli/automation).

## Docs for agents

```text
https://donebear.com/llms.txt
https://donebear.com/llms-full.txt
https://donebear.com/developers
https://donebear.com/openapi.json
https://donebear.com/auth.md
```

Most pages also have a markdown copy. Append `.md` to the URL:

```text
https://donebear.com/docs/ai-onboarding.md
```

## Quick verify

After connecting, ask:

> List my Done Bear tasks for Today

Then create one task in Inbox. The first MCP request opens a browser so the human can sign in. After that, authentication is automatic.

## What not to do

- Do not treat Done Bear as a sprint tracker or a kanban API. There are no sprints, boards, or status columns. Tasks live in Inbox, Today, Upcoming, Anytime, and Someday. Do not invent extra views, statuses, or fields. See [Views](/help/views).
- Agents do not take a seat. Done Bear bills per member, and an agent authenticates as an existing user over MCP OAuth or an API key, so it costs nothing on any plan, including Free. Connecting Claude, ChatGPT, Cursor, or Codex is included and not rationed. See [Plans and limits](/help/plans) and the [pricing page](https://donebear.com/pricing).