obsidian-mcp-server
A tool for manipulating and interacting with Obsidian vaults through Model Context Protocol.
GraphCanon updated Sep 20, 2026 · GitHub synced Sep 20, 2026
40views this month
Decision brief
The obsidian-mcp-server is a specialized utility for interacting with Obsidian vaults using the Model Context Protocol over STDIO or Streamable HTTP.
Good fit when
- When requiring precise manipulation of content, tags, and metadata within an Obsidian knowledge base through automated scripts or third-party applications that support the Model Context Protocol.
- For developers who need to integrate Obsidian data retrieval and modification functionalities directly into their TypeScript-based projects.
Avoid when
- When working with non-Obsidian knowledge bases as this tool is specifically designed for manipulating content within an Obsidian vault framework.
- If your project does not require the Model Context Protocol for communication, as this introduces a specific layer of protocol handling that may be unnecessary overhead.
- Pricing:
- freemium - Freely accessible and distributable with commercial usage allowed.
- Requirements:
- The software requires a running Obsidian vault, basic knowledge of TypeScript, and an understanding of Model Context Protocol for effective use.
Observed Jul 15, 2026 · Source: enrich:decision_facts
Verify the decision
Adoption
Package downloads where a registry match exists. GitHub stars (682) are secondary evidence.
- npm downloads (30d)
- 26,450·npm downloads API·Sep 20, 2026
Maintenance and security
Full trust report- Maintenance
- Very active (0d since push)
- As of Sep 20, 2026
- Provenance
- Not a fork · Personal account
- As of Sep 20, 2026
- Security (OSV)
- No lockfile
- As of Jul 26, 2026
Public GitHub metadata and optional OSV scans. Signals, not a guarantee. Trust methodology.
Install
npm install obsidian-mcp-serverSimilar tools
Same-category neighbours. No typed graph edges are catalogued for this tool yet.
Evidence and technical details
Sourced facts, taxonomy, compatibility claims, README excerpt, and machine-readable endpoints.
Overview
cyanheads/obsidian-mcp-server enables reading, writing, searching, and editing notes within Obsidian knowledge bases using the Model Context Protocol over STDIO or Streamable HTTP.
Capability facts
- Deploy
- Self-host
Source: dockerfile:Dockerfile · Sep 20, 2026
- Docker
- Dockerfile present
Source: dockerfile:Dockerfile · Sep 20, 2026
- CLI
- CLI entrypoint
Source: package.json:bin|scripts · Sep 20, 2026
- MCP server
- No MCP server detected
Source: repo_scan · Sep 20, 2026
- Languages
- typescript, javascript
Source: github.language+package.json · Sep 20, 2026
Categories
Compatibility
Sourced claims from the README excerpt - not unsourced marketing copy.
Source: README excerpt (regex_v1, Sep 20, 2026)
Or with npx (no Bun required):Source link
Tags
README
Getting started Add the following to your MCP client configuration file. The Obsidian Local REST API plugin must be installed and enabled in your vault — see Prerequisites. Or with npx (no Bun required): Or with Docker: The default ( ) points at the container's own loopback, not...
For agents
This page has a .md twin and JSON over the API.