# Procrastitask

> Reminders that escalate until they're dealt with. This API lets a user's own AI
> agent create, list, and complete that user's tasks on their behalf. An agent
> acts as the token's user, on that user's own tasks only.

## Authentication
Send `Authorization: Bearer <token>` on every request. Get a Personal Access
Token (`pk_...`) from the mobile app: Settings > Agent access. Scopes:
`tasks:read` and/or `tasks:write` (writes require `tasks:write`). All responses
use the envelope `{ "ok": bool, "data": ..., "error": string|null }`.

## Use the REST API
- Base URL: https://api.procrastitask.app
- [OpenAPI spec](https://api.procrastitask.app/openapi.json): machine-readable schema of every endpoint
- [Interactive docs](https://api.procrastitask.app/docs): Swagger UI
- Common calls: `GET /v1/tasks`, `POST /v1/tasks`, `GET /v1/tasks/{id}`,
  `POST /v1/tasks/{id}/complete`, `POST /v1/tasks/{id}/snooze`

## Or use MCP (same capabilities)
- Endpoint: https://api.procrastitask.app/mcp (streamable-HTTP)
- Add to Claude Code: `claude mcp add --transport http procrastitask https://api.procrastitask.app/mcp --header "Authorization: Bearer pk_..."`
- Tools: create_task, list_tasks, task_status, complete_task, snooze_task, set_escalation

## Guides
- [Connect your agent](https://api.procrastitask.app/guide)