What are the runtime requirements?

Node.js is required. The server is built with `npm run build` and runs as a command‑line MCP server using stdio transport.

Where does my vault data live?

All data remains in your local Obsidian vault directory. The server reads and writes markdown files on your filesystem; it does not send data to any external service.

SSyncDev

Start a project

Obsidian MCP Server

# Obsidian MCP Server A lightweight [Model Context Protocol (MCP)](https://modelcontextprotocol.io) server that enables AI assistants like Cursor &

Local serverstdioGo

What is the Obsidian MCP Server?

Obsidian MCP Server A lightweight Model Context Protocol (MCP) server that enables AI assistants like Cursor & Claude to read

More MCP options

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

Maintainer setup documentation.

How to install the Obsidian MCP Server

{
  "mcpServers": {
    "obsidian": {
      "command": "node",
      "args": [
        "obsidian-mcp-server/build/index.js",
        "/path/to/your/vault"
      ]
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Example prompts to try

“Use Obsidian to Read.”
“Use Obsidian to Write.”

Frequently asked questions

Alternative solutions like jacksteamdev/obsidian-mcp-tools are more feature‑rich but run as an Obsidian plugin. This server is intentionally lightweight and accesses files directly without requiring the Obsidian app to be open.