Skip to content
skillsdirectory
MCP Serversby cyanheads

obsidian-mcp-server

obsidian-mcp-server is a MCP server for integrations and connectors, published by cyanheads.

MCP server enabling AI agents to read, write, search, and surgically edit Obsidian vault notes, tags, and frontmatter with folder-scoped permissions and multiple search modes.

View obsidian-mcp-server source
Skill score
6.4/ 10
SolidProvisional

Is it any good?

Effectiveness · benchmark pending

We haven't benchmarked obsidian-mcp-server yet, so its score is provisional — computed from safety, maintenance, and documentation only, with popularity given no weight. When we benchmark it, we measure whether it produces materially better output than a frontier model alone, and that result leads the score. How we measure.

About obsidian-mcp-server

Description · AI-summarised from the cyanheads README

obsidian-mcp-server is a production-ready MCP (Model Context Protocol) server that bridges AI agents to Obsidian vaults via the Local REST API plugin. It provides 14 tools for comprehensive vault interaction: read notes in multiple formats (raw content, full structured form with links, document maps, or single sections), list and search notes with text/JSONLogic/BM25 modes, surgically edit specific headings/blocks/frontmatter fields, manage tags across frontmatter and inline representations, and control Obsidian command-palette commands. Features include folder-scoped read/write permissions, path normalization with case-insensitive matching, cursor-based pagination for large result sets, human-in-the-loop confirmation for destructive operations, and both STDIO and HTTP transports. Requires the Obsidian Local REST API plugin v4.0.0+ and Bun v1.3.11+ or Node.js v24+.

Where it fits

Browse related skills

Install obsidian-mcp-server

Install

Install via MCP server

{
  "mcpServers": {
    "cyanheads-obsidian-mcp-server": {
      "command": "npx",
      "args": ["-y", "@cyanheads/cyanheads-obsidian-mcp-server"]
    }
  }
}

Install with your AI

Zero install · paste into ChatGPT, Claude, Cursor…

Install the "obsidian-mcp-server" skill into my project by following all instructions at https://skillsdirectory.co/s/cyanheads-obsidian-mcp-server

Your assistant reads /s/cyanheads-obsidian-mcp-server and follows it — fetching the files from the source, placing them, and confirming before it runs anything. No account needed. How this works.

Frequently asked

FAQ

What does obsidian-mcp-server do?

MCP server enabling AI agents to read, write, search, and surgically edit Obsidian vault notes, tags, and frontmatter with folder-scoped permissions and multiple search modes.

How do I install obsidian-mcp-server?

obsidian-mcp-server is a MCP server. Primary install path: { "mcpServers": { "cyanheads-obsidian-mcp-server": { "command": "npx", "args": ["-y", "@cyanheads/cyanheads-obsidian-mcp-server"] } } }

What is the Skill Score for obsidian-mcp-server?

obsidian-mcp-server has a Skill Score of 6.4/10 (Solid). It is currently a provisional score — obsidian-mcp-server hasn't been benchmarked yet, so it weights safety 75/100 (40%), maintenance 50/100 (30%), and documentation 71/100 (30%). Popularity carries zero weight until effectiveness is measured. See methodology.

Is obsidian-mcp-server free?

obsidian-mcp-server is published under the Apache-2.0 license. See the vendor's source repository for any usage limits or paid tiers.

Related skills in Integrations and connectors

Related

Embed this score

For maintainers · always-current, links back

Skill Score badge for obsidian-mcp-serverPut it in your README — it updates as the score changes.
Markdown
[![Scored by skillsdirectory](https://skillsdirectory.co/badge/cyanheads-obsidian-mcp-server.svg)](https://skillsdirectory.co/skills/cyanheads-obsidian-mcp-server)
HTML
<a href="https://skillsdirectory.co/skills/cyanheads-obsidian-mcp-server"><img src="https://skillsdirectory.co/badge/cyanheads-obsidian-mcp-server.svg" alt="Scored by skillsdirectory" height="28" /></a>
Last updated May 23, 2026License: Apache-2.0How we score

/skills/cyanheads-obsidian-mcp-server