# Vortex Notes

> Vortex Notes is a free MCP server for knowledge and memory. Encrypted markdown notes that Claude, Cursor and other agents can search and write. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** Web, macOS, iOS, Android, CLI, self-hosted
- **Website:** https://vortex-notes.pages.dev
- **Repository:** https://github.com/vortex-303/vortex-notes
- **MCP Registry name:** io.github.vortex-303/vortex-notes
- **Categories:** knowledge and memory, productivity
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add vortex-notes -- npx -y vortex-notes
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "vortex-notes": {
      "command": "npx",
      "args": [
        "-y",
        "vortex-notes"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "vortex-notes": {
      "command": "npx",
      "args": [
        "-y",
        "vortex-notes"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "vortex-notes": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "vortex-notes"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "vortex-notes": {
      "command": "npx",
      "args": [
        "-y",
        "vortex-notes"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "vortex-notes": {
      "command": "npx",
      "args": [
        "-y",
        "vortex-notes"
      ]
    }
  }
}
```

## Tools

- `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.

## 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

- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Nautilus Compass Memory](https://ai-powered.com/mcp/nautilus-compass-memory): Nautilus Compass Memory is an open-source MCP server for knowledge and memory.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.

---
Source: https://ai-powered.com/mcp/vortex-notes
