Skip to content
MCP server

Vortex Notes

Encrypted markdown notes that Claude, Cursor and other agents can search and write

Runs locallyStatus and history
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-notes

Add to claude_desktop_config.json

{
  "mcpServers": {
    "vortex-notes": {
      "command": "npx",
      "args": [
        "-y",
        "vortex-notes"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "vortex-notes": {
      "command": "npx",
      "args": [
        "-y",
        "vortex-notes"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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

  1. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  2. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  3. Ha MCP

    MCP server

    MCP server for managing and automating Home Assistant from AI assistants

    Runs locally
    • 8 tools
    • Open source
    • 7.9K GitHub stars
    • Productivity
  4. MCP 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
  5. Local-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
  6. Concord MCP

    MCP server

    Local-first MCP server for messaging and shared work-state between coding agents

    Runs locally
    • Freemium
    • 1.3K GitHub stars
    • Developer tools