Get It Done

GetItDone for AI agents

Everything an AI assistant or agent needs to read our docs and build against the API — in machine-friendly formats.

Machine-readable indexes

Markdown twins

Append .md to any docs URL to get its Markdown source — ideal for feeding a page straight into a model.

https://nowgetitdone.com/docs/api.md
https://nowgetitdone.com/docs/api/operations/createTask.md
https://nowgetitdone.com/docs/api/problems/rate-limited.md

Connect over MCP

The GetItDone MCP server lets an assistant work with tasks directly — including image and video-frame context. Endpoint:

https://app.nowgetitdone.com/api/mcp

MCP server docs →

One platform: REST + SDK + MCP

The REST API, the TypeScript SDK, and the MCP server are three doors into the SAME platform — one credential, one set of scopes, one docs surface. The SDK is a typed client over the REST API, so its capabilities track REST exactly. The MCP server (8 tools) is a focused, agent-facing subset plus one capability REST deliberately does not expose.

Capability	REST /v1	SDK	MCP
Tasks — list, create, update, archive	Yes	Yes	Yes
Task full content + attachment URLs (read)	Yes	Yes	Yes
Workspaces / organizations (read)	Yes	Yes	Yes
Task history / versions	Yes	Yes	No
Daily plan	Yes	Yes	No
Projects	Yes	Yes	No
Members	Yes	Yes	No
Attachments — upload / download	Yes	Yes	No
Outbound webhooks	Yes	Yes	No
Usage & quota	Yes	Yes	No
Video-frame task contextMCP-only by design (see divergences)	No	No	Yes
Docs searchAgent convenience over the public docs pages	No	No	Yes

Documented divergences

get_task_video_context is intentionally MCP-only. Extracting frames from a task's videos so an agent can see them is an MCP-native rich-context capability; exposing raw extracted frames over REST is deliberately out of scope for v1. This is a documented divergence, not a missing feature.
The GitHub integration tools are copilot-only. They power the in-app AI copilot and have no public REST surface; adding GitHub actions to /v1 is a deliberate, owner-gated scope expansion — not a gap v1 intends to fill.

REST quickstart

Authenticate with a gid_ key over Bearer auth:

curl

curl https://app.nowgetitdone.com/v1/organizations \
  -H "Authorization: Bearer gid_YOUR_API_KEY"

Full API docs →

TypeScript SDK

A typed client is available — npm install @nowgetitdone/sdk (source on GitHub).

Agent behavior guidelines

Respect the scopes on the credential — request only what you need, and expect 403 insufficient_scope otherwise.
Send an Idempotency-Key on consequential POSTs so retries are safe.
Back off on 429 responses, honoring the Retry-After header.
Switch on the stable code in problem responses, never the human title.