A tiny local server that saves your context and loads it into any AI — Claude, Cursor, and more. It runs on your machine, in storage you own.
The same Markdown files everywhere. Start local, switch to the cloud anytime — your notes come with you.
Markdown files in a folder on your computer. Zero setup.
A private app folder in your own Dropbox. Contextly can't see anything else.
A single folder in your own Google Drive. Your account, your data.
Install once. Your AI gets a searchable memory — no more copy-pasting between apps.
save_contextStore a named contextappend_contextAdd to an existing onelist_contextsSee everything as a tablerecall_contextLoad it back into chatsearch_contextKeyword search with snippetsNo coding — just copy, paste, and click. About five minutes.
Contextly needs a small free program called Node to run. Open nodejs.org, click the big green “LTS” download button, and run the installer (just keep clicking Continue / Next). Already have it? Skip to step 2.
Download the ZIP, then double-click it to unzip. Move the resulting contextly folder somewhere easy to find, like your Documents.
Now open a Terminal window inside that folder and type this, then press Enter:
npm install
Mac: right-click the folder → “New Terminal at Folder”. Windows: open the folder, click the address bar, type cmd, press Enter. Wait for it to finish (a minute or two).
Choose one. The default (on your computer) needs no setup — the cloud options let you reach your notes from other devices.
~/.contextly). Skip to step 4 — you can always switch to a cloud later.In your Terminal, run:
node bin/contextly-auth.js dropbox
It asks for a Dropbox App key. To get one, make a free Dropbox “app” (~2 min). This lets Contextly save into its own folder in your Dropbox — it can’t see anything else:
Contextly, and click Create app.files.content.read and files.content.write, then click Submit.http://localhost:53682 and click Add.In your Terminal, run:
node bin/contextly-auth.js gdrive
It asks for a Client ID and Client secret. To get them, set up a free Google app (~4 min). Contextly only ever sees a single Contextly folder it creates:
Google may say the app is “unverified” — that’s normal for your own private app. Click Advanced → Go to (your app) to continue.
Choose the app you use:
Open Settings → Developer → Edit Config to open claude_desktop_config.json, then:
{}? Replace it with the whole block below."mcpServers": { … }? Add only the "contextly": { … } part inside those braces (comma after any existing server).{
"mcpServers": {
"contextly": {
"command": "node",
"args": ["PASTE-YOUR-CONTEXTLY-FOLDER/bin/contextly.js"]
}
}
}Replace PASTE-YOUR-CONTEXTLY-FOLDER with your unzipped folder from step 2, save, then quit and reopen Claude.
Easiest of all. In the Terminal from step 2, paste this and press Enter:
claude mcp add contextly -- node "$(pwd)/bin/contextly.js"
The $(pwd) part fills in your folder automatically. Then type /mcp in Claude Code to check it worked.
In Cursor, open Settings → MCP → Add new server, or edit the file ~/.cursor/mcp.json. Same rule as Claude Desktop:
"mcpServers"? Add only the "contextly": { … } part inside those braces (comma-separate it from any server already there).{
"mcpServers": {
"contextly": {
"command": "node",
"args": ["PASTE-YOUR-CONTEXTLY-FOLDER/bin/contextly.js"]
}
}
}Replace PASTE-YOUR-CONTEXTLY-FOLDER with your unzipped folder from step 2, then switch the server on in Cursor’s MCP settings.
Done! Ask your AI to “save this as a context,” then “recall” it later — even in a different app.
There's no Contextly cloud. Nothing you save ever leaves your machine or your account.
Just Markdown files. Read them, back them up, or move them anywhere.
Claude Desktop, Claude Code, Cursor — anything that speaks MCP.
Run it locally, keep your memory in your own storage. Free for personal use.
Get Contextly on GitHub