MCP Server Documentation

Connect Claude to Jade Note

Jade Note gives Claude secure access to your notes as a persistent memory layer. Claude can search, read, create, append, link, and maintain notes through Jade Note's MCP server while you keep control through OAuth, per-category access settings, previews, version history, and rollback.

Connector URL https://api.jadenote.app/mcp
Transport Streamable HTTP
Auth client Dynamic OAuth Client

What Jade Note Does for Claude

Jade Note is an AI notebook and MCP-native memory store. Once connected, Claude can use your Jade Note workspace during conversation instead of relying on copied context or one-off chat history.

  • Search notes by keyword or semantic meaning.
  • Read notes, categories, category wikis, links, freshness, and source metadata.
  • Create new notes, append to existing notes, and patch notes with previews.
  • Suggest and create typed links between related notes.
  • Use category-level access controls to separate read-write, read-only, and hidden memory.
  • Use version history and rollback when an AI-assisted edit needs to be inspected or undone.

Setup in Claude

  1. Open Claude's connector or MCP server settings.
  2. Add a new MCP server using https://api.jadenote.app/mcp.
  3. Select Streamable HTTP if Claude asks for transport support.
  4. Select Dynamic OAuth Client if Claude asks for OAuth client type.
  5. Start account linking and sign in to Jade Note when the browser opens.
  6. Review the requested access, approve it, and return to Claude.
  7. Test with a prompt such as "Search my Jade Note notes for recent project decisions."

Jade Note uses OAuth with Authorization Code and PKCE. Claude does not need your Jade Note password, and the MCP server issues scoped access tokens only after you approve the connection.

Access Controls

MCP access is controlled per category inside Jade Note. Use these settings before connecting Claude if you want to limit which notes Claude can see or modify.

Access level Behavior in Claude
read_write Claude can read, search, create, append, link, and update notes in the category.
read_only Claude can read and search notes, but write and maintenance tools are rejected.
no_access The category is hidden from MCP, including names, notes, snippets, links, and wiki content.

Common Fixes

Claude cannot connect

Confirm the server URL is exactly https://api.jadenote.app/mcp and that the selected transport is Streamable HTTP.

Sign-in or account linking fails

Restart the OAuth flow from Claude's connector settings. If the problem persists, sign in to Jade Note in the same browser first, then retry the connection.

Claude cannot find a note

Check the note's category access level. Categories set to no_access are intentionally invisible to Claude, and read_only categories cannot be changed.

A write should be reviewed or undone

Use Jade Note's preview, version history, checkpoint, and rollback features to inspect or restore prior note content.

Support

For connector setup, account linking, or MCP access issues, contact [email protected].