Agent setup

Set up GetItDone in Cursor

Let Cursor do it: paste this sentence and it follows the setup prompt itself. The steps below are the same ones, by hand.

Fetch and execute the appropriate instructions to set me up for GetItDone from https://nowgetitdone.com/agent-setup/prompt.md
Add to Claude

1. Get an API key

Create a key at Profile → API Keys and store it in your project's .env as GETITDONE_API_KEY=gid_…. Keep .env in .gitignore.

2. Connect the MCP server

Config: ~/.cursor/mcp.json (user level, outside the repository)

  1. Merge the getitdone entry below into ~/.cursor/mcp.json (create the file if needed; keep any servers already there), with the key in place of <key>. Never put this entry in the project's .cursor/mcp.json: that file can be committed.
  2. Tell the user to reload MCP servers in Cursor Settings → MCP so getitdone shows up.
json
{
  "mcpServers": {
    "getitdone": {
      "url": "https://app.nowgetitdone.com/api/mcp",
      "headers": { "Authorization": "Bearer <key>" }
    }
  }
}

No key? Leave out the headers line: Cursor asks the user to sign in to GetItDone the first time it uses the server.

3. Tell Cursor about GetItDone

Append this block to .cursor/rules/getitdone.mdc.

  • Start .cursor/rules/getitdone.mdc with four frontmatter lines — ---, description: GetItDone task API, alwaysApply: true, --- — so the rule loads in every chat.
  • Add .env to .gitignore if it is not already there, so the key never lands in a commit.
markdown
## GetItDone

GetItDone is the task manager this project talks to.

- MCP server: `getitdone` at https://app.nowgetitdone.com/api/mcp. Prefer it for tasks, projects and workspaces: call `search_tools` first, then run one `execute_typescript` program that calls the tools it found. When the connection reaches more than one workspace, pass the `workspaceId` from `list_workspaces`.
- REST API for everything else: base URL https://app.nowgetitdone.com/v1
- Auth: send the key from the GETITDONE_API_KEY environment variable as `Authorization: Bearer <key>`
- OpenAPI spec (source of truth for paths and payloads): https://nowgetitdone.com/docs/api/openapi.json
- Human reference: https://nowgetitdone.com/docs/api
- Errors are RFC 9457 problem+json: switch on `code`, back off on 429 honouring `Retry-After`, and send an `Idempotency-Key` on POSTs that create something.

Never print the key. Prefer reading the spec over guessing an endpoint.

4. Verify

sh
set -a; . ./.env; set +a
curl -s -H "Authorization: Bearer $GETITDONE_API_KEY" https://app.nowgetitdone.com/v1/organizations
curl -s -X POST https://app.nowgetitdone.com/api/mcp -H "Authorization: Bearer $GETITDONE_API_KEY" -H "Content-Type: application/json" -H "Accept: application/json, text/event-stream" -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

The first command lists the workspace the key belongs to; the second lists the MCP tools, including search_tools and execute_typescript. A 401 means the key is missing, revoked or mistyped.

Every client and the full tool list: MCP server guide.

We use analytics cookies to understand how GetItDone is used. Nothing is collected until you choose. What we collect