Menu

Your cove. Your tools.

Read your canvases, save to your library, and connect compatible tools with scoped access.

List your canvases
GET /api/v1/boards HTTP/1.1
Authorization: Bearer YOUR_API_KEY

Build with REST

Use narrow JSON endpoints for scripts and services that read canvases or work with saved library items.

Common uses

  • List and read canvases
  • List and search library items
  • Create or update a saved item

Connect through MCP

Give a compatible client a scoped Streamable HTTP connection through OAuth or a personal key.

Common uses

  • List and read canvases
  • Search saved library material
  • Capture a note to the inbox

Permissions you control

Create a key with a non-empty set of scopes and an expiry of up to 365 days. The raw key appears once. You can review its metadata and revoke it from Settings at any time.

Learn about API key management
Personal API key scopes
ScopeWhat it allowsMCP tools
boards:writeCapture selected web content to editable canvases. Also requires library:write.REST capture endpoint; no additional MCP tool
boards:readList and read canvases the account can view.list_canvases, read_canvas
library:readList and search the account’s own library.search_library
library:writeCreate, update and delete library items through REST.capture_note

Client and reference guides

CodexConnect with OAuth or keep a personal key in an environment variable.Claude DesktopAdd a public HTTPS endpoint through the remote OAuth connector flow.API referenceInspect the generated endpoint schemas, request bodies and response statuses.

Make your first connection.

Follow the API key guide before connecting a script or an MCP client.

Read the API key guide