# Vortex Notes MCP server

> Provides end-to-end encrypted markdown notes that serve as a searchable, structured memory for AI agents and users.

- Repository: https://github.com/vortex-303/vortex-notes
- Page: https://hostedmcp.org/servers/vortex-303/vortex-notes
- Transport: stdio
- Stars: 0
- License: MIT
- Latest version: 0.1.11

## Install

### Claude Code

```sh
claude mcp add vortex-notes -- npx -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"
      ]
    }
  }
}
```

### Claude Desktop (`claude_desktop_config.json`)

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

### Codex (`~/.codex/config.toml`)

```toml
[mcp_servers.vortex-notes]
command = "npx"
args = ["-y", "vortex-notes"]
```

### Gemini CLI (`~/.gemini/settings.json`)

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

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `VORTEX_NOTES_READONLY` | no | no | Set to 1 for search-and-read-only access. |
| `VORTEX_NOTES_VAULT` | no | no | Vault folder to serve. Optional: after `npx vortex-notes@latest pair` the paired vault is found automatically. |

## FAQ

### Can the server read my notes?

No, the server only stores ciphertext and cannot read any plaintext, titles, or keys.

### Does the search feature require an API key?

No, search is performed on-device using local embeddings and hybrid search.

### Can I use Vortex Notes with Claude.ai or ChatGPT?

Yes, you can create a cloud agent in the app to get a secret connector URL for web-based chat applications.