MCP server

Let an AI assistant search, read and write your notes and goals. You ask in plain words; it picks the right tool.

What you need

• The server address: https://beta.api.denotes.space/mcp
• An API key, sent as Authorization: Bearer <key>. See Authentication.

The key’s scopes decide which tools work. Give the assistant a read-only key if you only want answers, not changes.

Set up your assistant

Claude Code

claude mcp add --transport http denotes https://beta.api.denotes.space/mcp \
  --header "Authorization: Bearer dn_live_YOUR_KEY"

Cursor

Add this to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "denotes": {
      "url": "https://beta.api.denotes.space/mcp",
      "headers": { "Authorization": "Bearer dn_live_YOUR_KEY" }
    }
  }
}

VS Code

Add this to .vscode/mcp.json in your project:

{
  "servers": {
    "denotes": {
      "type": "http",
      "url": "https://beta.api.denotes.space/mcp",
      "headers": { "Authorization": "Bearer dn_live_YOUR_KEY" }
    }
  }
}

Claude Desktop

Claude Desktop starts servers itself, so it reaches DeNotes through the small mcp-remote bridge. Add this to claude_desktop_config.json and restart Claude:

{
  "mcpServers": {
    "denotes": {
      "command": "npx",
      "args": ["mcp-remote", "https://beta.api.denotes.space/mcp", "--header", "Authorization:${DENOTES_AUTH}"],
      "env": { "DENOTES_AUTH": "Bearer dn_live_YOUR_KEY" }
    }
  }
}

Other clients

Any client that speaks MCP over Streamable HTTP and can send a header will work. Use the address and header above.

Tools

The tool list could not be loaded just now. Your assistant can always list them itself.