Vortex Notes
Encrypted markdown notes that Claude, Cursor and other agents can search and write
- Pricing
- Free
- Platforms
- Web, macOS, iOS
- Runs
- Locally
- Version
- 0.1.11
- Listing updated
- 2 days ago
About Vortex Notes
Vortex Notes is a free MCP server for knowledge and memory. It runs locally on your machine and is started by your AI client.
Vortex Notes treats an agent as its own principal. Each agent gets a separate key, created on its own machine, limited to the spaces you grant, optionally read-only, with every edit signed as that agent and revocable in one step. The server only stores ciphertext: a 12-word phrase is the whole account, and keys are derived in the browser, so there is no password to reset.
The notes are plain markdown files, so Obsidian or any editor can open the synced folder. The MCP tools are task-shaped rather than a file mirror: search, read, surgical edit, daily journal entries, a remember call for facts that can be superseded while staying visible, and a build_context call that returns the top notes plus one hop of wikilinks. Search runs on the device using BM25 and a small multilingual embedding model, so no API key is needed and nothing leaves the machine.
Claude Code, Hermes and OpenCode are wired up by running npx vortex-notes pair and approving a code in the app. Claude web and ChatGPT developer mode connect through a per-app connector URL, which behaves like a password and lets the server read the notes that connector may see. Shell agents can use the same tools as plain commands.
Install
Run in a terminal
claude mcp add vortex-notes -- npx -y vortex-notesAdd to claude_desktop_config.json
{
"mcpServers": {
"vortex-notes": {
"command": "npx",
"args": [
"-y",
"vortex-notes"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"vortex-notes": {
"command": "npx",
"args": [
"-y",
"vortex-notes"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"vortex-notes": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"vortex-notes"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"vortex-notes": {
"command": "npx",
"args": [
"-y",
"vortex-notes"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"vortex-notes": {
"command": "npx",
"args": [
"-y",
"vortex-notes"
]
}
}
}Configuration
VORTEX_NOTES_VAULTVault folder to serve. Optional: after `npx vortex-notes@latest pair` the paired vault is found automatically.VORTEX_NOTES_READONLYSet to 1 for search-and-read-only access.
Tools this server provides (7)
Taken from the project documentation; the running server may differ.
- search_notes
- Searches notes with hybrid keyword and semantic matching.
- read_note
- Reads a note.
- write_note
- Writes a note.
- edit_note
- Makes a surgical edit to a note.
- append_daily
- Adds a timestamped journal entry.
- remember
- Stores a fact, optionally superseding an earlier one.
- build_context
- Returns top notes in full plus linked notes for a topic.
What it does
- Per-agent keys
- Each agent has scoped, revocable, signed access.
- Zero-knowledge sync
- The relay stores ciphertext only.
- On-device search
- Hybrid keyword and multilingual embedding search with no API key.
- Fact lifecycle
- remember lets a newer fact supersede an older one visibly.
- Context building
- One call returns top notes and linked notes.
- Read-only mode
- Set VORTEX_NOTES_READONLY=1 or use --read-only.
- Plain markdown vault
- Works with Obsidian and any editor.
Good for
- Give Claude Code long-term memory about a project
- Let several AIs share one set of notes
- Keep a daily journal that agents append to
- Revoke an agent's access without touching others
- Search notes written in another language
Pricing
Free
Mac app free (beta); no paid tiers published.
Prices change. Check vortex-notes.pages.dev before you buy.
Vortex Notes FAQ
Can the server read my notes?
The README says it stores ciphertext only, with no plaintext field in its schema; connector URLs for chat apps are an exception, since the server holds that connector's key.
How do I connect Claude Code?
Run npx -y vortex-notes@latest pair on the agent's machine and approve the 6-letter code in the app.
What does it cost?
The Mac app is described as free and in beta; no other pricing is published.
Does it work offline?
The app is installable and works offline, and search runs locally.
Is Vortex Notes free?
Yes. Vortex Notes is free to use.
How do I add Vortex Notes to Claude Code?
Run this command in your terminal: claude mcp add vortex-notes -- npx -y vortex-notes
What are the best alternatives to Vortex Notes?
The closest alternatives to Vortex Notes are Codebase Memory, XERJ, Ha MCP, Claude Code Ultimate Guide and Nautilus Compass Memory.
Alternatives to Vortex Notes

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ha MCP
MCP serverMCP server for managing and automating Home Assistant from AI assistants
Runs locally- 8 tools
- Open source
- 7.9K GitHub stars
- Productivity

Claude Code Ultimate Guide
MCP serverMCP server for searching the Claude Code Ultimate Guide from any MCP client
Runs locally- Open source
- 6.5K GitHub stars
- AI models and LLM tooling

Nautilus Compass Memory
MCP serverLocal-first long-term memory layer for AI agents, served over MCP
Not checked yet- 5 tools
- Remote
- Open source
- 1.3K GitHub stars
- Knowledge and memory

Concord MCP
MCP serverLocal-first MCP server for messaging and shared work-state between coding agents
Runs locally- Freemium
- 1.3K GitHub stars
- Developer tools