How do I install the obsidian mcp plugin mcp server?

Use a recorded configuration for your client, replace example credential values and paths, and verify the documented runtime. Restart or reconnect the client, then inspect the available tools.

SSyncDev

Start a project

Obsidian MCP Plugin MCP Server

Allow an AI to interact with your vault's notes through a self-contained MCP server

Local serverstdioTypeScript

What is the Obsidian MCP Plugin MCP Server?

Allow an AI to interact with your vault's notes through a self-contained MCP server

What the server does

This Obsidian plugin embeds an MCP (Model Context Protocol) server directly within Obsidian, providing a streamlined way for applications to interact with your vault.

Embedded MCP Server: — Hosts the MCP server within Obsidian itself as a plugin, simplifying setup and improving performance
Vault Access via MCP: — Exposes your vault through standardized tools
Structured Data Support: — Define custom schemas for structured note creation and validation
File Operations: —
Read and write files
Fuzzy search across your vault

Credentials and setup notes

Basic knowledge of TypeScript and Obsidian API A nix flake is provided to create a standardized development environment.

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
obsidian-mcp-read-file	Get file contents
obsidian-mcp-diff-edit-file	Edit files using simplified udiff (see [below](#obsidian-mcp-diff-edit-file))
obsidian-mcp-search-contents	Fuzzy search across the contents of all files in your vault
obsidian-mcp-search-filenames	Fuzzy search across all file names in your vault
obsidian-mcp-list-files	List files and directories in your vault with customizable depth and result limits
obsidian-mcp-upsert-file	Create or update files
obsidian-mcp-rollback-edit	Roll back the last edit to a markdown file (reverts the last change made by supported tools)

How to install the Obsidian MCP Plugin MCP Server

{
  "mcpServers": {
    "obsidian": {
      "command": "npx",
      "args": ["mcp-remote", "http://localhost:<your_server_port>/sse"]
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

Basic knowledge of TypeScript and Obsidian API A nix flake is provided to create a standardized development environment.

Example prompts to try

“Use Obsidian MCP Plugin to obsidian-mcp-read-file.”
“Use Obsidian MCP Plugin to obsidian-mcp-diff-edit-file.”
“Use Obsidian MCP Plugin to obsidian-mcp-search-contents.”

Frequently asked questions

Allow an AI to interact with your vault's notes through a self-contained MCP server Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.