DeNotes API

Read and write your notes, files, folders and goals from your own code, or let an AI assistant work with them.

Two ways in

• REST API, for scripts, automations and apps. Plain HTTP and JSON at https://beta.api.denotes.space/v1. See the API reference.
• MCP server, for AI assistants like Claude, Cursor and VS Code. The assistant picks the right tool for what you ask. See MCP server.

Both use the same API keys, permissions and rate limit.

Quickstart

1. Create an API key

Open DeNotes, go to Settings → Developer API and choose Create API key. Pick what the key may do, then copy it. It is shown only once.

2. Make your first request

List your most recently changed note:

curl https://beta.api.denotes.space/v1/notes?limit=1 \
  -H "Authorization: Bearer dn_live_YOUR_KEY"

{
  "data": [
    {
      "id": "V1StGXR8_Z5jdHi6B-myT",
      "title": "Weekly review",
      "fileId": null,
      "goalId": null,
      "phaseId": null,
      "tags": ["work"],
      "favorite": false,
      "archived": false,
      "pinned": false,
      "order": 0,
      "contentAvailable": true,
      "createdAt": "2026-11-02T09:14:00Z",
      "updatedAt": "2026-11-12T16:40:00Z"
    }
  ],
  "pagination": { "limit": 1, "offset": 0, "total": 42, "nextOffset": 1 }
}

3. Write something

Creating a note needs a key with notes:write. The body is saved to your Google Drive, like any note you write in the app.

curl https://beta.api.denotes.space/v1/notes \
  -H "Authorization: Bearer dn_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title": "Ideas", "content": "- Try the API", "tags": ["inbox"]}'

What the API does not do

• It never deletes anything.
• It cannot see anything in your Private Vault. Locked items are left out of lists and return 404.
• Note bodies need Google Drive connected in the app.