Connect Claude to your notes
note2it speaks MCP (Model Context Protocol), the open standard AI assistants use to work with your tools. Connect an assistant like Claude, Perplexity, or Gemini and ask it to search, read, and — if you allow it — edit your notes. You stay in control: you choose what each assistant can do, every change is undoable, and you can revoke access any time.
Available on the Premium and Pro plans.
Option 1 — One click in Claude (recommended)
Works in Claude on the web, desktop, and mobile.
- In Claude, open connector settings and add a custom connector with this URL:
https://app.note2it.com/api/mcp/mcp - Claude sends you to a note2it screen. Sign in, choose whether the assistant may read only or also edit, and approve.
- That's it — Claude can now work with your notes. No keys to copy.
Option 2 — An API token (Claude Code & headless tools)
- In note2it, go to Settings → AI assistants and create a token with the access you want (read, or read + edit). Copy it — it's shown only once.
- Add note2it to your client with the token, for example in Claude Code:
claude mcp add --transport http note2it https://app.note2it.com/api/mcp/mcp --header "Authorization: Bearer YOUR_TOKEN"
Desktop apps that launch a local server
Claude Desktop, Cursor and other clients that start MCP servers from a config file can run the official note2it bridge. It forwards every request to the hosted note2it server with your API token — nothing else to install, and the token never leaves your computer except to reach note2it over HTTPS. Create a token in Settings → AI assistants, then add:
{
"mcpServers": {
"note2it": {
"command": "npx",
"args": ["-y", "@note2it/mcp"],
"env": { "NOTE2IT_API_KEY": "YOUR_TOKEN" }
}
}
}Requires Node.js 18 or later. Prefer a direct connection where your app supports remote servers: it uses OAuth, so there's no token to paste.
Connect Perplexity
Perplexity connects to note2it with an API token. Custom connectors require a Perplexity Pro, Max, or Enterprise plan.
- In note2it, go to Settings → AI assistants and create a token with the access you want (read, or read + edit). Copy it — it's shown only once.
- In Perplexity, open Settings → Connectors → Add connector → Custom, and enter the note2it server URL:
https://app.note2it.com/api/mcp/mcp - Set the authentication method to “API key” and add an “Authorization” header whose value is the word Bearer, a space, then your token:
Authorization: Bearer YOUR_TOKEN - Save the connector. Perplexity verifies it right away — then ask it to search or read your notes.
Connect ChatGPT
ChatGPT calls connectors “apps”. Developer mode and Deep Research connectors require a ChatGPT Business, Enterprise, or Edu plan.
Full access — Developer mode
Read and edit your notes, like Claude. Uses OAuth, so there's no key to copy.
- In ChatGPT, turn on Settings → Connectors → Advanced → Developer mode, then add a custom connector with this URL:
https://app.note2it.com/api/mcp/mcp - Choose OAuth. ChatGPT sends you to a note2it screen — sign in, pick read or read + edit, and approve. No client ID or secret to enter.
Deep Research
Let ChatGPT's Deep Research search your notes and cite them in its report (read-only).
- Add a second custom connector pointing at the Deep Research URL:
https://app.note2it.com/api/deep-research/mcp - Authorize it the same way, then pick note2it as a source when you start a Deep Research run.
Connect Gemini
Gemini connects to note2it through Google Antigravity — Google's agent app that replaced the standalone Gemini CLI for individuals — using a note2it API token.
- In note2it, go to Settings → AI assistants and create a token with the access you want (read, or read + edit). Copy it — it's shown only once.
- In Antigravity, open the Agent panel, then choose ⋯ → MCP Servers → Manage MCP Servers → View raw config.
- Add note2it to the mcpServers object, with your token as the bearer:
{ "mcpServers": { "note2it": { "serverUrl": "https://app.note2it.com/api/mcp/mcp", "headers": { "Authorization": "Bearer YOUR_TOKEN" } } } } - Save the file and restart Antigravity — then ask Gemini to search or edit your notes.
Tools your assistant gets
These are the exact tool names an assistant sees once connected. Read tools work with either permission; edit tools need read + edit.
note2it-searchReadSearch page titles and text across every notebook you can read, with filters for notebook, section, tag and date.
note2it-fetchReadOpen one page as Markdown, or as an outline of its blocks for precise edits.
note2it-browseReadList your notebooks, sections and pages in order.
note2it-linksReadShow a page's backlinks, outgoing links and graph neighbours.
note2it-tagsReadList your tags and how often each is used.
note2it-list-templatesReadList your page templates and their fill-in fields.
note2it-create-pageRead + editCreate a page from Markdown, with [[wiki-links]] and #tags.
note2it-create-from-templateRead + editCreate a page by filling in one of your templates.
note2it-patch-pageRead + editEdit part of a page — add under a heading, replace a block, fix a phrase — without touching the rest.
note2it-update-pageRead + editReplace a page's title or full content (saved first, so it can be restored).
note2it-move-pageRead + editMove a page to another section or notebook, or reorder it.
note2it-trash-pageRead + editMove a page to trash, or restore it. Never deletes permanently.
note2it-page-historyRead + editList a page's saved versions and restore one.
note2it-upload-imageRead + editImport an image from a public https URL into your media library.
The setup on this page is the only official one. The hosted server is at the URL shown above, and the only official package is @note2it/mcp.
Optional: give your assistant a memory
note2it never tells your assistant to remember things on its own — it only does what you ask. If you'd like it to remember your preferences and decisions across chats, paste these lines into your assistant's own instructions. You can change or remove them any time.
Use my note2it notes as your memory. At the start of a conversation, search my note2it notes tagged #memory and use what's relevant. When I share a lasting preference, project detail or decision, or say "remember this", save it as a short page in my note2it notebook "AI Memory", tagged #memory, with today's date. Check first whether a page on that topic already exists and add to it instead. Never save passwords, keys, or anything I ask you to keep out of my notes.
Where to paste it
- Claude (web, desktop, mobile): Settings → Profile → personal preferences. To use it in one project only, paste it into that Project's instructions instead.
- ChatGPT: Settings → Personalization → Custom instructions.
- Claude Code: add the lines to your CLAUDE.md.
Saving needs the read + edit permission. Memory pages are ordinary notes: read, edit or delete them like any other page.
What an assistant can do
- Search and read across your notebooks, sections, and pages.
- Create pages and make precise edits — add a line under one heading, fix a sentence — without rewriting the whole page.
- List your page templates and fill one in to create a new page.
- Follow your [[wiki-links]], find backlinks and broken links, and work with your tags.
You stay in control
- Read-only or read + edit — you choose at the approval screen.
- See every connected assistant in Settings → AI assistants and revoke any of them instantly.
- Every edit an assistant makes is saved beforehand and can be restored; deleted pages go to a restorable trash.
- Connected-assistant activity is recorded in your account's security log.
The full picture — what can reach your notes, when, and how to shut it off — is on our Trust page.
Ready to try it?
Create an account, then connect Claude from Settings.