Connect your AI agent to Procrastitask

Drive your Procrastitask reminders from Claude Code, Claude Desktop, Cursor, or any tool that speaks MCP - or straight from the REST API. Your agent acts as you, on your own tasks only.

1. Get a token

In the Procrastitask app: Settings → Agent access → Connect an agent. Create a token, choose read-only or read & write, and copy the pk_... value (shown once).

2a. Connect via MCP (Claude Code)

claude mcp add --transport http procrastitask \
  https://api.procrastitask.app/mcp \
  --header "Authorization: Bearer pk_your_token"

Tools: create_task, list_tasks, task_status, complete_task, snooze_task, set_escalation.

2b. Or call the REST API directly

# list your open tasks
curl -s https://api.procrastitask.app/v1/tasks?status=open \
  -H "Authorization: Bearer pk_your_token"

# create one
curl -s -X POST https://api.procrastitask.app/v1/tasks \
  -H "Authorization: Bearer pk_your_token" \
  -H "Content-Type: application/json" \
  -d '{"title":"call the dentist","due_at":"2026-07-20T09:00:00Z","mode":"escalate"}'

Full reference: interactive API docs · OpenAPI spec · llms.txt

Scopes & safety

Scope	Allows
`tasks:read`	list and inspect tasks
`tasks:write`	create, complete, snooze, update

Treat the token like a password - it is sent over HTTPS only. Revoke it any time in the app under Settings → Agent access.