mcpbeat Sign in

Vortex Notes MCP Server

by vortex-303 Your server? Claim it
local only

Vortex Notes runs on your own machine — the client starts it, so there is no endpoint to ping. 701 installs a week from npm. Last commit 30 Oct 2026.

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

Installs per day peak 688 · avg 26 · +6910% w/w
a month agotoday
701
Installs / week
npm · vortex-notes
0
Stars
0 open issues
30 Oct 2026
Last commit
4 releases in 90 days
MIT
License
TypeScript

What the code does

We read the source, 3 d ago · rules 995398eba69f

Capabilities

What this server is able to do. For an MCP server this is often the job itself — a terminal server runs commands because that is what it is for. Listed so you know what you are plugging in, not as an accusation.

Builds a database query by concatenation ios/VortexKit/Sources/VortexKit/Notes/MarkdownEditing.swift:93
        let insert = "\n" + next
Runs an external command src/wire.ts:19
  spawnSync(cmd, args, { input, encoding: "utf8", timeout: 30000 });
Reads files and sends them to the network src/agents.ts:228
  for (const entry of fs.readdirSync(base, { withFileTypes: true })) {
Long encoded blob in source src/relay/brand.ts:7
export const FAVICON_ICO_B64 = "AAABAAMAEBAAAAEAIADmAQAANgAAACAgAAABACAABAQAABwCAAAwMAAAAQAgAG0GAAAgBgAAiVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8/9hAAABm0lEQVR4nJyTyy8DURTGvzMznaK0nWo9Es9ICFv+B7GzZG8hVvwXdnZih52lhYW1sJOykGiFqEckjLbTl3b6Ou6dhVRfol8yyZ2Z7/fde+49VwNARqh/A4qyDvA0gXS0…

Is this your server and something here is wrong? Tell us — corrections are free and do not require a plan.

This code can reach further than it looks

We found places where it runs commands, builds paths or queries from values it is given. None of that is a flaw by itself — it becomes one when the code changes, and code changes quietly between releases. We re-read it on every one.

Three servers free · no card

Connect this server

This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.

run in your terminal
claude mcp add vortex-notes -- npx -y vortex-notes
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "vortex-notes": {
      "command": "npx",
      "args": [
        "-y",
        "vortex-notes"
      ]
    }
  }
}
~/.codex/config.toml
[mcp_servers.vortex-notes]
command = "npx"
args = ["-y", "vortex-notes"]
.cursor/mcp.json
{
  "mcpServers": {
    "vortex-notes": {
      "command": "npx",
      "args": [
        "-y",
        "vortex-notes"
      ]
    }
  }
}
.vscode/mcp.json
{
  "servers": {
    "vortex-notes": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "vortex-notes"
      ]
    }
  }
}

Optional settings from the registry entry, left out of the block above: VORTEX_NOTES_VAULT (Vault folder to serve. Optional: after `npx vortex-notes@latest pair` the paired vault is found automatically), VORTEX_NOTES_READONLY (Set to 1 for search-and-read-only access).

Alternatives to Vortex Notes

same job, measured the same way
Kijito
by kijito

Shared memory and mail for your AI agents. Verified with Claude Code; other MCP clients in testing.

answering
Inboxwatch
by cloudcorprecords

An E2E encrypted mailbox for AI agents: claim an address, send and receive sealed messages.

431 installs/wk local only
TestGraph
by bbcbasic

Shared semantic graph for AI reviews, classification and structured memory across AI assistants.

37 tools answering
TestAtlas
by karzone

Semantic map of a .NET test-automation solution for AI agents — search, impact, endpoints

local only
AgentVault
by motiveflowllc

Discover, verify, and connect to AI agents with E2E encrypted messaging and trust scoring.

88 installs/wk local only
Idea Launch
by idea-launch

Validate SaaS and app ideas with real, managed ad tests from your coding agent.

answering
M
Mockpost
by reiarseni

Local multi-channel message emulator for E2E testing, with MCP tools for LLM agents.

66 installs/wk local only
ShieldFive
by shieldfive

Move files off your computer into an E2E-encrypted vault, verified first. Decrypts locally.

146 installs/wk local only

Vortex Notes — questions

Answers built from our own checks of this server.

Why is there no uptime for Vortex Notes?
Vortex Notes runs on your own machine over stdio — there is no network address to reach, so uptime cannot be measured for it by anyone. What can be measured is adoption: the npm package vortex-notes was installed 701 times last week.
How do I connect Vortex Notes?
Copy the ready config from this page. We generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each in the form that client actually reads. It runs locally, so the command pulls vortex-notes straight from npm; nothing to host, nothing to sign up for.
How many people use Vortex Notes?
The npm package vortex-notes was installed 701 times in the last week. Week over week that is +6910%. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.
Is Vortex Notes open source?
Yes — it is published under the MIT licence, written in TypeScript and 0 stars on GitHub. The source link is on this page, so you can read exactly what it does with your data before you connect it.