# Vortex Notes (npm · vortex-notes)

E2E-encrypted markdown notes as shared memory for you and your agents, with local semantic search.

- Trust score: 67/100 (medium)
- Change this week: +9
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-11-05

## Components

- npm · `vortex-notes`: 67/100 (this document), [markdown](https://verifymcp.io/servers/vortex-303-vortex-notes/vortex-notes.md), [page](https://verifymcp.io/servers/vortex-303-vortex-notes/vortex-notes)

## Channel facts

- Registry: `npm`
- Package: `vortex-notes`
- Version: `0.1.11`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-11-05.

- **Supply Chain Security**: 81/100
  - No malware found by supply-chain analysis.
  - CVE check failed: a known high-severity CVE affects zod 3.25.76, a direct dependency. A fixed version is available.
  - No install/post-install scripts declared.
  - 61 of 223 dependencies flagged as unhealthy (1 deprecated).
- **Provenance & Transparency**: 45/100
  - Source repository is publicly reachable at the declared URL.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 6 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 72/100
  - AI-judged instruction clarity (good).
  - Tool/resource definitions use about 645 tokens (~71/item across 9 items; 9 tools + 0 resources), lean.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 23/100
  - Stability observed for 7 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 94/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 83% of tool parameters carry a description.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - We read all 9 captured tool definition(s), and no name or description among them implies an irreversible operation.
  - An AI judge read all 9 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## Install

### How do I install the Vortex Notes MCP server?

Vortex Notes runs locally as an npm package, launched with npx -y vortex-notes. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add vortex-303-vortex-notes -- npx -y vortex-notes
```

### Cursor

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

### VS Code

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

### Codex

```bash
codex mcp add vortex-303-vortex-notes -- npx -y vortex-notes
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "vortex-303-vortex-notes": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "vortex-notes"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add vortex-303-vortex-notes --command npx --arg -y --arg vortex-notes
```

### Hermes

```yaml
mcp_servers:
  vortex-303-vortex-notes:
    command: "npx"
    args: ["-y", "vortex-notes"]
```

### Netclaw

```json
{
  "McpServers": {
    "vortex-303-vortex-notes": {
      "Transport": "stdio",
      "Command": "npx",
      "Arguments": [
        "-y",
        "vortex-notes"
      ]
    }
  }
}
```

### Vellum

```bash
assistant mcp add vortex-303-vortex-notes -t stdio -c npx -a -y vortex-notes
```

### Other

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

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-11-04 (score 67, +1)

No change was recorded against any check on this day. Stability & Change Management went from 17 to 20. That category is still filling its 30-day observation window: 5 days of observed history at the previous scan, 6 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-11-02 (score 66, +1)

No change was recorded against any check on this day. Stability & Change Management went from 10 to 13. That category is still filling its 30-day observation window: 3 days of observed history at the previous scan, 4 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-10-31 (score 65, +1)

No change was recorded against any check on this day. Stability & Change Management went from 3 to 7. That category is still filling its 30-day observation window: 1 days of observed history at the previous scan, 2 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-10-30 (score 64, +6)

- [security regression] CVE-2026-114113 affects this package: high
- [security regression] CVE-2026-114111 affects this package: high
- [security regression] CVE-2023-54404 affects this package: high
- [security regression] CVE-2026-114112 affects this package: high
- [security regression] Known CVEs: unverified → fail
- [functional improvement] Dependency health: unverified → 0.89

### 2026-10-29 (score 58)

First indexed and scored.

## MCP tools (9)

### `search_notes` (~71 tokens)

Search notes

Search the vault with hybrid keyword + semantic search. Returns note paths, headings, and snippets. Use read_note for full content.

Input parameters:

- `limit` (integer): Max results (default 8)
- `mode` (string): Search mode (default hybrid)
- `query` (string, required): Natural-language or keyword query

### `read_note` (~39 tokens)

Read note

Read a note's full markdown content by vault-relative path.

Input parameters:

- `path` (string, required): Vault-relative path, e.g. 'projects/idea.md'

### `write_note` (~72 tokens)

Create note

Create a new markdown note. Fails if the path already exists — use edit_note to modify existing notes.

Input parameters:

- `content` (string, required): Markdown body
- `folder` (string): Optional vault-relative folder, e.g. 'projects'
- `tags` (array)
- `title` (string, required): Note title

### `edit_note` (~84 tokens)

Edit note

Edit an existing note surgically: append, prepend, or find_replace (exact string). Prefer this over rewriting whole notes.

Input parameters:

- `content` (string, required): Text to append/prepend, or replacement text for find_replace
- `find` (string): Exact string to find (find_replace only)
- `operation` (string, required)
- `path` (string, required): Vault-relative path

### `append_daily` (~64 tokens)

Append to daily note

Append a timestamped entry to today's daily note (or a given date). The right place for observations, decisions, and things to remember.

Input parameters:

- `content` (string, required): Markdown for the entry (one bullet)
- `date` (string): YYYY-MM-DD (default: today)

### `build_context` (~90 tokens)

Build context

Load working context for a topic in one call: full content of the top-matching notes plus one hop of [[wikilinked]] notes as pointers. Prefer this over multiple search+read rounds when starting work on a topic.

Input parameters:

- `max_notes` (integer): Primary notes to include in full (default 4)
- `topic` (string, required): Topic, question, or entity to build context for

### `remember` (~143 tokens)

Remember a fact

Record a durable fact in the shared memory (memory/*.md) as a dated bullet with a stable ^id. If it replaces an earlier fact, pass supersedes (the old fact's ^id, or a distinctive substring of it) — the old fact stays visible with strikethrough and a pointer to the new one. Use search_notes to find existing facts first.

Input parameters:

- `fact` (string, required): The fact, stated so it makes sense without conversation context
- `supersedes` (string): ^id or distinctive substring of the fact this replaces
- `topic` (string): Optional topic — facts go to memory/<topic>.md instead of memory/facts.md

### `recent_activity` (~41 tokens)

Recent activity

List notes modified in the last N days, newest first.

Input parameters:

- `days` (integer): Lookback window (default 7)
- `limit` (integer)

### `list_notes` (~41 tokens)

List notes

List note paths, optionally under a folder.

Input parameters:

- `folder` (string): Vault-relative folder to list (default: whole vault)
- `limit` (integer)

## Diagnostics

Captured diagnostic sections: Provenance, Vulnerabilities, Dependencies. The full working is on the page: https://verifymcp.io/servers/vortex-303-vortex-notes/vortex-notes#diagnostics

## Score history

- 2026-11-05: 67
- 2026-11-04: 67
- 2026-11-03: 66
- 2026-11-02: 66
- 2026-11-01: 65
- 2026-10-31: 65
- 2026-10-30: 64
- 2026-10-29: 58

## Common questions

### What is the Vortex Notes MCP server?

Vortex Notes is an MCP server listed in the public MCP registry as io.github.vortex-303/vortex-notes. E2E-encrypted markdown notes as shared memory for you and your agents, with local semantic search. This page covers its npm package (vortex-notes).

### Is the Vortex Notes MCP server safe to use?

Vortex Notes scores 67 out of 100 on VerifyMCP. We recorded 4 known advisories against it as of 5 November 2026. It declares no install or post-install scripts. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the Vortex Notes MCP server expose?

Vortex Notes exposes 9 tools: search_notes, read_note, write_note, edit_note, append_daily, and 4 more. Their descriptions and schemas cost roughly 645 tokens of context every time the server is loaded.

### Is the Vortex Notes MCP server still maintained?

Vortex Notes is still listed as active in the MCP registry. We last reached this channel on 5 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

### What licence is the Vortex Notes MCP server under?

Vortex Notes declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.

## Links

- npm package: https://www.npmjs.com/package/vortex-notes
- Socket report: https://socket.dev/npm/package/vortex-notes
- Repository: https://github.com/vortex-303/vortex-notes
- Website: https://vortex-notes.pages.dev/
- Changelog RSS feed: https://verifymcp.io/servers/vortex-303-vortex-notes/vortex-notes.xml
- Changelog JSON feed: https://verifymcp.io/servers/vortex-303-vortex-notes/vortex-notes.json
- HTML version of this page: https://verifymcp.io/servers/vortex-303-vortex-notes/vortex-notes