Log inSubmit server
Obsidian Turbocharged logo

Obsidian Turbocharged

Governed MCP access to Obsidian vaults with ACLs, audit logs, retrieval, memory, and controlled write tools.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Obsidian Turbocharged

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "obsidian-turbocharged": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-tc"
      ],
      "env": {
        "OBSIDIAN_TC_CONFIG": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

We couldn’t confirm it starts correctly

We ran the install command but it didn't respond within our test window — this can mean a slow first-time install rather than a real problem.

npx -y obsidian-tc

No response to initialize.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 4d ago.

Overview

Obsidian Turbocharged MCP server provides governed access to Obsidian vaults through the Model Context Protocol. It routes tool calls through authentication, folder ACLs, read-only controls, destructive-operation confirmation, and audit logging. Retrieval combines full-text, vector, and graph search, while memory features store episodes and forgetting data inside the vault. Reach for it when agents need controlled multi-vault access or more than basic note reading and writing.

Use cases

  • Search an Obsidian vault with lexical, vector, and graph retrieval
  • Enforce folder-level access controls for agent vault operations
  • Review and audit agent edits to notes
  • Store agent memory inside an Obsidian vault
  • Require confirmation for destructive note operations

Key features

  • Governed Obsidian vault access over MCP
  • Folder ACLs and authentication
  • Read-only control and destructive-operation confirmation
  • Full-text, vector, and graph retrieval
  • In-vault memory with decay and forgetting
  • Three-tool capability facade

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

7/7 checks healthy over the last 41d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 15h ago via OSV.dev · obsidian-tc (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars10Stargazers on the source repository.
npm downloads4.3kPackage downloads in the last 30 days.
Last commitTodayMost recent push to the default branch.
Install checkInconclusiveDidn't respond in our test window — often a slow first install.
Directory activity6 viewsConfig copies, upvotes, and views on AllMCPs.

How Obsidian Turbocharged works

What Obsidian Turbocharged does

The Obsidian Turbocharged MCP server connects AI agents to Obsidian vaults without exposing unrestricted filesystem access as the primary interface. It provides governed note access, retrieval, and in-vault memory through MCP tools. Read operations include note retrieval, vault search, and backlink lookup. Write operations support whole-note edits, appending, heading- or block-based patching, frontmatter changes, and tag or link maintenance.

The server also supports separate scopes for higher-risk actions, including note deletion, moving notes, bulk property updates, command execution, and vault administration. Memory data uses the vault as its storage location and is subject to the same access controls as other writes.

How it works

Each capability passes through a shared dispatch pipeline. Depending on configuration, that pipeline can apply authentication, folder-level access rules, a read-only kill switch, human confirmation for destructive actions, and audit logging. The server can expose capabilities directly or present three meta-tools: find_capability, describe_capability, and call_capability. The default facade is the three-tool mode; domain and flat modes are also available.

Search combines lexical, vector, and graph retrieval. Semantic search uses a bundled offline embedder by default in the documented quick-start path. The project also includes optional native acceleration with a JavaScript fallback.

Setup and configuration

For a single local vault, start the Obsidian Turbocharged MCP server with npx obsidian-tc /path/to/vault. This makes note tools and lexical search available immediately. A configuration file is the appropriate option for multi-vault setups, authentication, or ACLs:

Terminal
npm install -g obsidian-tc
obsidian-tc ./obsidian-tc.config.json

The configured installation requires Node 24 or newer, or Bun 1.1 or newer. Docker images, standalone binaries, and an .mcpb bundle are also available. Cursor and VS Code can use a stdio configuration with npx and the OBSIDIAN_TC_CONFIG environment variable. The bundle can be installed in Claude Desktop and other MCPB hosts.

An optional TC Bridge plugin extends Local REST API for Obsidian-specific features. Local REST API must be installed first, and bridge access requires restApiUrl and restApiKey in the vault configuration. Filesystem-level features do not require the bridge.

Tools and capabilities

  • Read notes, search the vault, and inspect backlinks.
  • Write, append, and patch notes.
  • Update frontmatter, tags, and links.
  • Delete or move notes under separate scopes.
  • Apply bulk property changes.
  • Execute commands when the corresponding capability is enabled.
  • Add or reload vaults through administrative capabilities.
  • Use full-text, vector, graph, and memory-oriented retrieval.

Limitations and notes

The Obsidian Turbocharged MCP server is heavier than a simple read-only wrapper or a direct Obsidian API integration. The zero-configuration command starts with authentication disabled and no folder ACLs, which is intended for local-only use. npm and Docker installation paths require explicit embedding-provider configuration according to the project documentation.

The optional bridge is desktop-only and crosses a trust boundary because its REST API key functions as a vault-root password. The project is licensed under AGPL-3.0, whose network-copyleft terms may matter for commercial deployments. It is maintained by a single maintainer, and the repository identifies version 1.32.0 as shipped.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Obsidian Turbocharged

Obsidian Turbocharged is an MCP server that connects AI agents to Obsidian vaults with governed access controls. Its main tools support reading, searching, writing, patching, backlink inspection, retrieval across full-text, vector, and graph indexes, and in-vault memory, with auditing and confirmation for sensitive operations.

Install it with `npx obsidian-tc /path/to/vault` for a local vault. For configuration-based setups, install globally with npm and run `obsidian-tc ./obsidian-tc.config.json`; Node 24+ or Bun 1.1+ is supported. Docker, standalone binaries, and an `.mcpb` bundle are also available.

Yes, Obsidian Turbocharged works with Cursor through a stdio MCP configuration. Use `npx` as the command and pass the package name, optionally setting `OBSIDIAN_TC_CONFIG` to an absolute configuration-file path.

Agent writes pass through the server's governance pipeline, which can apply authentication, folder ACLs, read-only mode, human confirmation for destructive operations, and audit logging. Separate scopes cover ordinary edits, deletion, moves, bulk changes, command execution, and administration.

Related MCP servers

All in Knowledge & Memory All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewObsidian Turbocharged AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/obsidian-turbocharged?style=directory)](https://allmcps.com/mcp/obsidian-turbocharged)
HTML Embed
<a href="https://allmcps.com/mcp/obsidian-turbocharged"><img src="https://allmcps.com/api/badge/obsidian-turbocharged?style=directory" alt="Obsidian Turbocharged on AllMCPs" /></a>