obsidian-mcp-server
A TypeScript MCP server that connects to an Obsidian vault through the community Local REST API plugin, version 4.0.0 or later, so Obsidian must be running with that plugin enabled and its API key set.
What it does
A TypeScript MCP server that connects to an Obsidian vault through the community Local REST API plugin, version 4.0.0 or later, so Obsidian must be running with that plugin enabled and its API key set. It runs locally over stdio or can be served over Streamable HTTP. Its 14 tools read notes whole or by section, list folders and tags, search by text or JSONLogic, write, append, patch or find-and-replace inside notes, edit frontmatter and tags, delete notes and open files in the Obsidian window. Running command-palette commands is off unless enabled, and reads and writes can be limited to chosen folders. A companion skill describing multi-step workflows ships with it.
Capabilities
- Read an Obsidian note in full or one section
- Search notes by text or JSONLogic
- Write, append to or patch a heading, block or frontmatter field
- Find and replace text inside a note
- Manage a note's frontmatter and tags
- Open a file in the Obsidian app
About
- Publisher
- cyanheads
- Tool
- Obsidian
Install
MCP servers and skills can run code on your computer and act on your data. Review the source before installing.
Details
| Fact | Value | Source |
|---|---|---|
| Type | MCP server | |
| Tool | Obsidian | |
| Publisher | cyanheads | source |
| Official status | Community (not published by the tool's vendor) | source |
| Connection | Local or remote | source |
| Can change data | Yes | source |
| Needs an API key or sign-in | Yes | source |
| Platforms | Not stated in its documentation | |
| AI clients | Claude Code, Claude Desktop, Cursor, Visual Studio Code | source |
| Licence | Apache-2.0 | source |
| Pricing | Not stated in its documentation | |
| Activity | Last commit Oct 31, 2026Version 3.9.0703 GitHub starsDownload data not available (not on npm or PyPI) | source |
| Links | Repository Website npm: obsidian-mcp-server |
More from cyanheads
3 servers
All 3 from cyanheads →Sources
- GitHub repositorygithub.com/cyanheads/obsidian-mcp-server · Backs: AI clients, Can change data, Connection, Official status, Publisher, Activity, LicenceNov 10, 2026
- Licence file (LICENSE)github.com/cyanheads/obsidian-mcp-server · Backs: LicenceNov 12, 2026
- GitHub repositorygithub.com/cyanheads/obsidian-mcp-server · Backs: Needs an API key or sign-inNov 12, 2026
- MCP Registry entryio.github.cyanheads/obsidian-mcp-server · Backs: ConnectionNov 14, 2026
- npm package recordnpmjs.com/package/obsidian-mcp-serverNov 14, 2026