Ctxfile MCP Server

One context, every agent, all local. Website · Docs · Clients · The .ctxfile convention · Security

People connecting this server to Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.

VERIFIED ACTIVE

LAST COMMIT 2026-08-08 · ★ 4 · #232 OF 848 MAINTAINED OTHER · VERIFIED 2026-08-25

Apache-2.0 · TypeScript servers · how we verify → /methodology

01 · Install Ctxfile

Claude Code

claude mcp add ctxfile-ctxfile -- npx -y ctxfile

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "ctxfile-ctxfile": {
      "command": "npx",
      "args": [
        "-y",
        "ctxfile"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

repo age created 2026-07-13 - young repo, little track record yet

license Apache-2.0 - declared in the repository

npm package ctxfile - unscoped; check the name against the project README before installing

registry vendor namespace dev.ctxfile - domain-verified with the official MCP registry

03 · What Ctxfile can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

Latest releases

v0.4.0 · 2026-07-20

Point ctxfile at an Obsidian vault (any folder of markdown) and every agent you use loads your notes as context - read-only, fully local, redacted like everything else. · Vault connector (free core): notes join…

v0.1.0 · 2026-07-13

ctxfile v0.1.0 - the free, open-source core. · Local-first MCP server that snapshots your project's working state (files, git, Notion, local-LLM summary) into one structured context object any MCP client can load.…

04 · Who maintains Ctxfile

ctxfile is maintained by ctxfile. It's the only MCP server we track from this author; the repo dates to Jul 2026.

05 · Facts

repository: github.com/ctxfile/ctxfile
website: https://ctxfile.dev/
category: other - ranked #232 of 848 actively-maintained other servers as of 2026-08-25.
release cadence: 2 releases in the last 90 days (latest 2026-07-20)
registry: dev.ctxfile/ctxfile (active, first published 2026-07-13 · 7 versions)
packages: npm:ctxfile

06 · Ctxfile FAQ

What is Ctxfile?

One context, every agent, all local. Website · Docs · Clients · The .ctxfile convention · Security

Is Ctxfile still maintained?

Yes - as of 2026-08-25, its last commit was 2026-08-08 and it shipped 2 releases in the last 90 days. We re-verify nightly.

How do I install Ctxfile?

Run `npx -y ctxfile`. You can also paste the ready-made client config above.

Does Ctxfile run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Ctxfile

Alternatives to Ctxfile

Maintained other servers if Ctxfile isn't the fit.

More MCP servers to compare · Cueapi MCP Server · Bezelbub MCP · Biorxiv MCP Server · Brapi MCP Server · Census MCP Server

More TypeScript MCP servers · Peek · Arxiv MCP Server (cyanheads) · Aviation Weather MCP Server · see all