cyanheadsCommunity·14 Agent Skills Included

obsidian-mcp-server

Let AI read, write, search, and organize your Obsidian vault

Connects AI agents to your Obsidian vault to read, write, search, and edit notes, tags, and frontmatter. Eliminates manual note hunting and copy-paste by giving agents surgical edit tools with path safety rules and delete confirmations. Runs over STDIO or HTTP so Claude, Cursor, and other MCP clients can manage your knowledge base directly.

673|102

↗

npx skills add cyanheads/obsidian-mcp-server --all -g -y

Available:

Gives the AI agent the server's operating rules, including routing all vault access through the Obsidian service, enforcing path-permission policies, and requiring user confirmation before destructive actions like deleting notes.

All Skills in This Repository (14)

Pure Emerald Level Indicators

📦 In Repo

cyanheads

api-telemetry

Implement OpenTelemetry instrumentation to generate traces and metrics in JavaScript/TypeScript.

tool-defs-analysis

Audit tool, resource, and prompt definitions for consistency and leaks.

api-canvas

add-resource

Scaffold new MCP resource definitions with URI templates, handlers, and registration.

add-test

Scaffold Vitest test files for MCP tools, resources, services, and prompts.

api-testing

Test MCP tool and resource handlers with mock contexts and Vitest fixtures.

api-config

Documents environment variable configuration for core and server layers in mcp-ts-core.

setup

Guides post-init orientation and onboarding for MCP servers scaffolded with @cyanheads/mcp-ts-core.

maintenance

Investigate, adopt, and verify dependency updates for Bun-based MCP server projects.

add-tool

Scaffold new MCP tool definitions with the mcp-ts-core tool() builder pattern.

code-simplifier

Reviews git diffs and simplifies changed code against existing codebase patterns.

add-service

Scaffold a new service integration module with init/accessor pattern and retry logic.

Community

Advanced

Frequently Asked Questions

FAQPage Schema

How to install obsidian-mcp-server?▼

Run `npx skills add cyanheads/obsidian-mcp-server --all -g -y` in your terminal to install the full suite globally. You also need the Obsidian Local REST API plugin and an API key set as OBSIDIAN_API_KEY.

What can AI do with my Obsidian vault?▼

Your agent can search notes by text or tags, read full notes or single sections, create and append content, edit frontmatter, manage tags, and even run Obsidian commands. Destructive actions like deleting a note always ask for your confirmation first.

Is my Obsidian vault safe from unwanted AI edits?▼

Yes. The server enforces read/write path allowlists, a read-only mode, and refuses to overwrite existing files unless you explicitly allow it. Deletes require a confirmation round before anything is removed.

Does obsidian-mcp-server work with Claude and Cursor?▼

Yes. It follows the standard MCP protocol and works with Claude Desktop, Claude Code, Cursor, VS Code, and other MCP-compatible clients over STDIO or HTTP.

Can I use it without coding experience?▼

Yes. Once installed and connected with your API key, you simply ask your AI assistant in plain English to find, summarize, or update notes in your vault.