API & Webhooks

Give Codex, Claude, or your own scripts full read/write access to this workspace.

API keys

No keys yet.

MCP endpoint

Point Codex / Claude / Cursor at this URL. It exposes tools for tasks, columns, tags, and members.

/mcp

REST API

Base URL: /api/public/v1. Auth: Authorization: Bearer <key>.

GET /databases

GET /databases/:id/columns

GET /databases/:id/tasks

POST /databases/:id/tasks { values: { "Task": "Buy milk", "Status": "To do" } }

PATCH /tasks/:id { values: { "Status": "Done" } }

DELETE /tasks/:id

POST /columns/:id/options { name: "Urgent", color: "red" }

GET /members

POST /members { name: "Alice" }

Tip: `values` keys accept column names (case-insensitive) or ids. Missing select/multi-select tags are auto-created.

Webhooks

Receive task.created, task.updated, task.deleted events. Requests are signed with HMAC-SHA256 in x-notion-clone-signature.

No webhooks yet.

Dispatch runs when you call GET /api/public/webhooks/dispatch with your API key. Trigger it from a cron, GitHub Action, or your own worker every minute.