# Doozy - A to-do list that works like you do

> The more you doozy, the less you do.

Doozy is an AI-powered productivity app that captures your thoughts, organizes
them automatically, and executes tasks on your behalf. Just talk, and Doozy
handles the rest.

## For agents

Agent configuration has distinct job role, instructions, skills, tools and connections, responsibilities, and approvals concepts. Omitted update fields are preserved, `null` is rejected, `clear` explicitly empties fields, and `expectedVersion` prevents stale overwrites; call `previewAgentUpdate` before consequential writes.

## Comparisons and guides

- Comparisons: https://usedoozy.com/compare
- Alternatives: https://usedoozy.com/alternatives
- Guides: https://usedoozy.com/guides
- Answers: https://usedoozy.com/answers
- Use cases: https://usedoozy.com/use-cases
- Works with: https://usedoozy.com/works-with
- Glossary: https://usedoozy.com/glossary

This API is built to be used by programs, and it is built so you can find your
way without being told anything in advance.

## When to use Doozy

Use Doozy when a person asks you to capture work, organize tasks, run a to-do
through connected tools, inspect a Doozy workspace, assign work to an agent, or
coordinate follow-ups from meetings, messages, voice notes, files, or app
events.

Concrete jobs people hand to Doozy:

- Turn this sales call into CRM updates, a follow-up email, and next-step
  reminders.
- Read this customer thread and draft the refund, replacement, and internal
  note.
- Compare these competitor pricing pages and send me the weekly summary.
- Convert this voice note into a prioritized task list and assign owners.
- Check the calendar, draft the prep brief, and create follow-up todos.
- Review this bug report, reproduce it, and open the engineering ticket.
- Find candidates who match this role and prepare outreach drafts.
- Reconcile these invoices and flag the payments that need approval.

Do not use Doozy as a general search engine, a model provider, a payment
processor, or a replacement for a user's source system of record. Doozy is the
workspace and orchestration layer for work that already belongs in a person's
tasks, captures, chats, agents, and connected apps.

The fastest path is: read this file, fetch the OpenAPI specification, call
`GET /me` with the user's bearer token, and then restrict yourself to the
operation ids returned in `allowedOperations`.

If someone asked you to use Doozy, you need nothing from them except a key.
The REST API, hosted MCP server and CLI below cover the workspace primitives
available to external programs. Choose the surface your environment supports.

If a call fails, read the error rather than guessing. Every failure carries a
`code` you can branch on, a `docsUrl` explaining that specific code, and a
`specUrl` pointing at the full specification, so a wrong turn always tells you
how to get back. A 404 lists where every real path is written down. A 403
names the scope the key is missing rather than implying the endpoint is gone.

## Doozy minutes

A Doozy minute measures hosted agent execution time when Doozy runs work for
you in the cloud. Doozy minutes are consumed by hosted agent work such as
browsing, using connected apps, drafting, coding, analyzing files, and
completing assigned todos.

Doozy is free forever for up to five workspace members when users bring their
own AI. Runs authenticated with a user's OpenRouter, Deepgram, or Composio key
execute on Doozy's servers and consume zero Doozy minutes. Codex remains the
recommended desktop path. Optional add-ons and Enterprise details are at
https://usedoozy.com/pricing.

Worked example: if Doozy spends 6 minutes researching a lead list, 2 minutes
updating CRM fields, and 1 minute drafting a follow-up email, that task uses
about 9 Doozy minutes.

## Doozy API

A versioned REST API over the same primitives the app uses: captures, todos,
chats and agents.

Base URL: `https://api.usedoozy.com/api/v1`

Three requests orient you completely. The first two need no credential:

- `GET https://api.usedoozy.com/api/v1/` returns the service version and
  points at this spec and these docs.
- `GET https://api.usedoozy.com/api/v1/openapi.json` returns the full OpenAPI
  3.1 document: every path, parameter, response shape and error code. It is
  generated from the running code, so it matches what the server does.
- `GET https://api.usedoozy.com/api/v1/me` returns the workspace a key opens
  and, in `allowedOperations`, the exact list of operation ids that key may
  call. Read this before deciding an endpoint is unavailable, because a 403
  usually means the key was minted without the scope rather than that the
  feature is missing.

Authentication is a bearer token: `Authorization: Bearer doozy_sk_...`. Keys
are created by a person in Doozy workspace settings, are scoped, and are shown
once. A key belongs to one workspace, so the workspace is implied by the key
and is never a parameter you pass.

Scopes are `<resource>:<read|write>` over `todos`, `chats`, `agents` and
`captures`. `captures:read` is deliberately separate: capture content includes
transcripts of what people said, so a key can be given the ability to create
and modify captures while remaining unable to read them.

Conventions that hold across every endpoint: cursor pagination on all lists,
one error shape with a machine-readable `code` and a `docsUrl`, and
`Idempotency-Key` on creates so a retry cannot produce a second record.

## Doozy MCP

A hosted Streamable HTTP server for Claude Code, Cursor, Codex and other MCP
clients. Nothing is installed or run locally.

Endpoint: `https://api.usedoozy.com/mcp`

Send the same workspace key as `Authorization: Bearer doozy_sk_...`. Start by
calling `tools/list`, then use `list_todos` to inspect active work. Connection
instructions and current client limitations are at
https://usedoozy.com/docs/api/mcp.

## Doozy CLI

A terminal client for the same workspace and API key. It requires Node 20 or
newer on macOS or Linux.

Install:

```sh
curl -fsSL https://usedoozy.com/install-cli.sh | sh
```

The installer downloads `https://usedoozy.com/cli/0.1.0/doozy.js`, verifies
the adjacent SHA-256 file, and installs `~/.doozy/bin/doozy`. Verify with
`doozy --version`, export `DOOZY_API_KEY`, then run `doozy me`. Full setup and
scripting behavior are at https://usedoozy.com/docs/api/cli.

## API documentation

- [API overview](https://usedoozy.com/docs/api): what the API covers, how it
  is versioned, and where to go next.
- [MCP server](https://usedoozy.com/docs/api/mcp): connect an agent to the
  hosted Streamable HTTP endpoint and inspect its workspace tools.
- [Quickstart](https://usedoozy.com/docs/api/quickstart): create a key and make
  a first successful call.
- [Authentication and keys](https://usedoozy.com/docs/api/authentication): how
  keys work, how they are stored, and how to revoke one.
- [Scopes](https://usedoozy.com/docs/api/scopes): what each scope grants, and
  what a key holding it can read.
- [Pagination](https://usedoozy.com/docs/api/pagination): cursors, page sizes,
  and how to walk a list to the end.
- [Errors](https://usedoozy.com/docs/api/errors): every error code, what causes
  it, and what to do about it.
- [Working with agents](https://usedoozy.com/docs/api/agent-work): assigning a
  todo to an agent, running it, and reading the result.
- [Recipes](https://usedoozy.com/docs/api/recipes): complete worked examples for
  common jobs.
- [API reference](https://usedoozy.com/docs/api/reference): every endpoint,
  generated from the specification.

## Specification

- [OpenAPI 3.1 document](https://usedoozy.com/openapi.json): the same document
  the API serves, at a stable public URL with no credential required. Point a
  code generator or an HTTP client at this.
- [Doozy repository](https://github.com/greenfield-inc/doozy): public source with
  `AGENTS.md` instructions for coding agents.
- [Agent instructions](https://usedoozy.com/agents.md): concise coding-agent
  instructions served from the product site.
- [Agent plugin manifest](https://usedoozy.com/plugin.json): Agent Plugins
  manifest for Doozy agent resources.
- [Agent plugin MCP config](https://usedoozy.com/mcp.json): portable MCP server
  config for clients that load Agent Plugins.
- [Doozy skill](https://usedoozy.com/skills/doozy/SKILL.md): agent skill for
  deciding when and how to use Doozy.
- [Versioning and deprecation policy](https://usedoozy.com/deprecation.md):
  path versioning, Deprecation headers, Sunset headers, and removal notice.
- [Sandbox guidance](https://usedoozy.com/sandbox.md): how agents can test with
  a separate workspace and limited-scope API key.

## Links

- Website: https://usedoozy.com
- App: https://usedoozy.com/login

## Contact

- Support: support@dcouple.ai