obsidian-mcp
A Node.js MCP server that runs locally over stdio and edits Obsidian vaults by working on the Markdown files directly, so the Obsidian app does not have to be open.
What it does
A Node.js MCP server that runs locally over stdio and edits Obsidian vaults by working on the Markdown files directly, so the Obsidian app does not have to be open. Each vault is named with an absolute path at startup, up to ten at once, and must already contain an .obsidian folder. Tools let the assistant read, create, edit, move and delete notes, create folders, search content, file names and tags, and add, remove or rename tags across a vault. Moving a note rewrites links that point to it, deletion goes to a recoverable trash by default, and changes are logged as transactions that can be restored. Node.js 22 or newer is required.
Capabilities
- Read, create and edit notes in Obsidian vaults
- Move or rename notes and update links to them
- Search note content, file names and tags
- Add, remove and rename tags across a vault
- Delete notes to a recoverable trash
About
- Publisher
- StevenStavrakis
- Tool
- Obsidian
Install
- Add this to Any client's configuration:
{ "mcpServers": { "obsidian": { "command": "npx", "args": ["-y", "obsidian-mcp@2", "serve", "--vault", "notes=/absolute/path/to/vault"] } } }
From the project's documentation · Add to a config file with the config builder
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 | StevenStavrakis | source |
| Official status | Community (not published by the tool's vendor) | source |
| Connection | Local (runs on your computer) | source |
| Can change data | Yes | source |
| Needs an API key or sign-in | No | source |
| Platforms | Not stated in its documentation | |
| AI clients | Not stated in its documentation | |
| Licence | MIT | source |
| Pricing | Not stated in its documentation | |
| Activity | Last commit Oct 8, 2026Version 2.0.1752 GitHub starsDownload data not available (not on npm or PyPI) | source |
| Links | Repository Website npm: obsidian-mcp |
Sources
- GitHub repositorygithub.com/StevenStavrakis/obsidian-mcp · Backs: Can change data, Connection, Official status, PublisherNov 12, 2026
- Licence file (LICENSE)github.com/StevenStavrakis/obsidian-mcp · Backs: LicenceNov 12, 2026
- GitHub repositorygithub.com/stevenstavrakis/obsidian-mcp · Backs: Activity, LicenceNov 18, 2026
- npm package recordnpmjs.com/package/obsidian-mcpNov 18, 2026