Connect an AI app

Connect an AI assistant to RealNotes so it can find and read your notes when you ask. You sign in and approve access yourself; the assistant never sees your password.

The server address for every app below is:

https://www.realnotes.online/api/mcp

Use exactly this address, including www. Without it, most apps fail to connect.

Tested with Claude Code and the Claude desktop app. The steps for the other apps follow their published documentation, but we haven’t run them ourselves yet, and menus change often. If a step doesn’t match what you see, look for the app’s “add a custom MCP server” option, or tell us.

What an assistant can do

When you approve a connection you choose how much to allow. Reading is always included; editing is a separate checkbox, off unless you tick it.

Always (read access)

List your folders, notes and tags, search your notes, and read a note’s text.
See backlinks, the link graph, and how your tags relate to each other (for example works_at).
Read notes that others shared with you.

Only if you tick “Create and edit your notes”

Create notes and folders.
Edit the title, text or folder of notes you own, add text to the end of a note, and rename or move folders.
Add relations between tags, written as lines on a tag’s page, and fix mistakes in them by removing a related tag, renaming a label or removing an inverse declaration. It can’t delete notes or tags.
Each edit is rate limited and recorded in an audit log with the app’s name. An edit fails if the note changed after the assistant read it, and one that would wipe out most of a long note is refused unless the assistant explicitly confirms it.
There is no undo history yet, so only turn on editing for apps you trust.

Never

Delete notes or folders, or empty the trash.
Change a note’s confidentiality or who it’s shared with.
See notes you marked confidential. They don’t exist as far as an assistant is concerned.
Edit notes shared with you; those are read-only.
Touch your account, password or settings.

Anything an assistant reads is sent to that AI provider, under their terms. Agent access may also be limited to certain plans; if it isn’t available to you, the approval screen says so.

Refer to a note by the number shown in the app, for example “read note 17”.

Claude Code · tested

In a terminal, run:

claude mcp add --transport http --scope user notes https://www.realnotes.online/api/mcp

Start Claude Code and run /mcp.
Pick notes, then Authenticate. Your browser opens RealNotes; sign in and choose Approve.
Ask something like “what’s in note 17?”.

Leave out --scope user to make it available in the current project only.

Other commands you may need:

claude mcp list

claude mcp get notes

claude mcp remove notes

list shows whether the connection is working, get shows its details, and remove disconnects it. To change the address, remove it and add it again.

Claude (desktop app, claude.ai and Cowork) · desktop app tested

Open Settings → Connectors and choose Add custom connector.
Name it “RealNotes” and paste the server address. Leave any client ID or secret fields empty.
Choose Connect, sign in to RealNotes and approve.
In a chat, turn the connector on from the tools menu.

Custom connectors need a paid Claude plan. On Team and Enterprise plans an organization owner may need to add the connector first.

ChatGPT · not yet tested

Open Settings → Connectors (or Apps), then Advanced settings, and turn on Developer mode. This is only offered on some paid plans.
Choose Create to add a custom connector. Name it “RealNotes” and paste the server address.
Set authentication to OAuth, accept the warning for unverified connectors, and create it.
Sign in to RealNotes and approve.
In a chat, turn the connector on from the tools menu.

Google Antigravity · not yet tested

In the Agent panel, open the … menu, choose Manage MCP Servers, then View raw config (this opens mcp_config.json).
Add this entry. Antigravity uses serverUrl, not url:

{
  "mcpServers": {
    "notes": {
      "serverUrl": "https://www.realnotes.online/api/mcp"
    }
  }
}

Save, then refresh the server list. Your browser opens RealNotes to sign in and approve.

Any other app

Any app that supports remote MCP servers with OAuth sign-in should work. Add a server with the address above and the “streamable HTTP” transport if it asks. Apps that only run local servers aren’t supported.

Troubleshooting

“Protected resource … does not match expected”: you used the address without www. Remove the server and add it again with the exact address above.
The approval screen says agent access isn’t turned on, or isn’t on your plan: it’s currently unavailable for your account.
“Not granted” or “reconnect” errors: approve access again from the app’s authenticate or reconnect option.
Too many requests: assistants are rate limited. Wait a minute and try again.

Stopping access

Remove the connector in the AI app to stop it using RealNotes. A screen in Settings to review and revoke connected apps is coming.