Home

obsidian-tc

Obsidian Turbocharged — the comprehensive, model-agnostic, agent-ready Model Context Protocol server for Obsidian. Built for both humans and autonomous agents. Multi-vault native. Pluggable embeddings. Works with local Ollama or cloud models.

Status: Shipped — v1.3.3 (2026-07-03). The full G4 implementation (milestones M0–M7) is merged to main, published to npm as provenance-signed packages, with a container image at ghcr.io/the-40-thieves/obsidian-tc. The surface is 105 tools across 28 domains. Licensed AGPL-3.0-only.

Three pillars

1. Comprehensive. ~105 tools covering every meaningful Obsidian operation, including native Bases (.base), Canvas, Excalidraw, and a deep set of plugin bridges. No other MCP exposes the full surface.
2. Safe by default. JWT auth (HS256 or asymmetric RS256/ES256/EdDSA via JWKS), root and per-vault folder ACLs, a global read-only kill switch, human-in-the-loop (HITL) confirmation on destructive operations, single-use idempotency keys, and per-class rate limiting.
3. Observable from day one. OpenTelemetry traces, Prometheus metrics on /metrics, a CloudEvents spool, and structured event emission on every tool call.

Quick start

npm install -g obsidian-tc
obsidian-tc serve --vault /path/to/vault

See Installation for the full matrix (Bun, Docker, standalone binary, native module) and Configuration for the config schema and ACL setup.

What it is — and what it is not

obsidian-tc is an access and control MCP: vault read/write, search, embeddings, structured-format handling, plugin bridges, capture, and memory entities. Retrieval intelligence (GraphRAG, hybrid BM25 + vector + RRF fusion, reranking, typed-atom memory) is the converged-engine direction tracked for a later line — see Architecture for the scope boundary. For the shipped v1.x, pair obsidian-tc with an external retrieval/RAG service if you need ranked reasoning on top of the search substrate.

Wiki map

Page	What's in it
Installation	Install methods, toolchains, the companion plugin, native module
Configuration	ServerConfigSchema, vaults, auth, ACL, embeddings, transports, throttle
Architecture	Components, dispatch pipeline, IPC contracts, multi-vault registry
Tool Reference	All 28 domains and 105 tools with one-line descriptions
Deployment Modes	STDIO, HTTP local, HTTP remote, Docker, standalone binary
Security and ACL	Scopes, HITL thresholds, kill switch, idempotency, elicit tokens
Plugin Bridges	Companion plugin, discovery probe, supported third-party plugins
Observability	OTLP traces, Prometheus metrics, CloudEvents, JSONL traces
Contributing	Dev setup, conventions, adding a tool, release process
FAQ	Common questions and gotchas

Architecture at a glance

Polyglot monorepo:

Package	Language	Purpose
packages/server	TypeScript (Bun)	MCP protocol layer, auth, routing, tool impls, plugin bridges
packages/plugin	TypeScript	Companion Obsidian plugin extending Local REST API
packages/native	Rust (napi-rs)	Perf-critical primitives: cosine similarity, tokenizer, BM25
packages/shared	TypeScript	Shared Zod schemas and types

Links

• Repository: https://github.com/The-40-Thieves/obsidian-tc
• npm: obsidian-tc
• Container: ghcr.io/the-40-thieves/obsidian-tc
• MCP spec target: 2025-11-25

Trademark

obsidian-tc is not affiliated with or endorsed by Obsidian.md. "Obsidian" is a trademark of Dynalist Inc. This is an independent open-source MCP server that integrates with Obsidian.