Private mode
On this page
Private mode runs notegraph on your own computer, with no notegraph server and no account. It is for people at home in a terminal. Everyone else should use the connector.
A standalone vault that syncs end-to-end encrypted across your machines, through a bucket you own. Import your Obsidian vault in one command.
Start here#
Your notes live on your own computer, as plain text. You connect an AI app, such as Claude Code or Claude Desktop, and ask it in your own words to find, add or change notes. notegraph keeps a record of each change, and you undo the ones you do not want. There are two ways to set it up.
With your AI#
If your AI assistant can run commands on your computer, it can do the setup. Copy this sentence and paste it to your assistant.
Paste this to your AI assistant
Read https://notegraph.sh/docs/private-mode/ai-setup/ and set up notegraph for me. Follow the steps on that page exactly. When you finish, tell me what you did and what I have to do myself.
It sends your assistant to a setup guide written for it. Today the guide tells it that notegraph is not released yet, and to stop there.
Yourself#
- Install notegraph and make your vault. It takes two commands in a terminal.
- Connect an MCP client: Claude Code or Claude Desktop.
How the pieces fit#
The core is one program. It keeps your notes and their full history in a local store, and it runs the terminal
commands (log, show, revert, sync and the rest). The MCP server
is a thin layer on top. Your agent starts it with notegraph mcp, and it offers sixteen tools. There is
no notegraph server and no account.
Use#
- History and undo: see each change with its diff, and revert it.
- Sync your machines through a bucket you own.
- Import and backup: bring in an Obsidian vault, read a note as Markdown, back up.
Reference#
- Tools: inputs, outputs and errors of the sixteen MCP tools.
- Set up with your AI: the guide that an AI assistant follows to install notegraph.
About#
- Privacy: what stays on your device, what goes to your bucket, and what notegraph cannot stop.
Words used in these docs#
- AI assistant, or agent
- An AI app that can do things for you, such as Claude Code or Claude Desktop. The docs say agent where the app acts by itself.
- MCP
- The Model Context Protocol: the standard way an AI app connects to a tool. notegraph is such a tool, and your AI app is the MCP client.
- Vault
- The place on your computer where notegraph keeps your notes and the full history of their changes.
- Terminal
- The window where you type commands. On a Mac it is the app called Terminal.
- Markdown
- Plain text with a few marks, such as # for a heading. Your notes stay in this form, so any editor can read them.
- Change, and the log
- Each time a note is written, notegraph records a change: what, who, when and on which computer. The log is the list of changes.
- Revert
- To undo a change. The old text comes back, and the undo is recorded as a change too.
- Sync
- Keeping the same notes on all your computers. It is off until you turn it on.
- Bucket
- Storage space that you rent from a cloud company, such as Cloudflare R2. Sync puts your notes there in locked form, so the company cannot read them.
- Denied folder
- A folder that you hide from every AI assistant. The tools cannot read it, write it or find it in a search.