MCP.so
Sign In

Obsidian MCP Server

@MCP-Mirror

About Obsidian MCP Server

Mirror of

Basic information

Category

Memory & Knowledge

Runtime

node

Transports

stdio

Publisher

MCP-Mirror

Config

Add this server to your MCP-compatible client using the configuration below.

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

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Obsidian MCP Server?

Obsidian MCP Server is a lightweight Model Context Protocol (MCP) server that enables AI assistants such as Cursor and Claude to read from and write to your Obsidian vault. It provides direct filesystem access without requiring the Obsidian application to be running, making it suitable for users who want AI-driven note management and automation.

How to use Obsidian MCP Server?

Install via npm (npm install obsidian-mcp-server), build (npm run build), then configure the server in Claude Desktop or Cursor by pointing to the compiled index.js file and your vault’s file path. Example commands are provided for both Claude Desktop and Cursor.

Key features of Obsidian MCP Server

  • Retrieve a list of all filenames in your vault.
  • Read the contents of one or multiple files.
  • Find all open TODO items across markdown files.
  • Create or update any file with new markdown content.
  • Standalone server – no need for Obsidian to be open.

Use cases of Obsidian MCP Server

  • Create a new note for tomorrow’s standup summarizing today’s code changes.
  • Ask your AI assistant to check your notes about project ideas.
  • Query what todos you have related to refactoring across your vault.

FAQ from Obsidian MCP Server

How does Obsidian MCP Server compare to other Obsidian MCP solutions?

This implementation is intentionally lightweight and standalone. Alternatives like jacksteamdev/obsidian-mcp-tools offer a more feature-rich approach as an Obsidian plugin.

Does it require Obsidian to be running?

No, the server accesses the vault’s files directly on the filesystem, so Obsidian does not need to be open.

How do I install and configure the server?

Run npm install obsidian-mcp-server and npm run build. Then add the server to your Claude Desktop or Cursor configuration, specifying the path to the built index.js and your vault directory.

What tools does it provide?

It provides four tools: getAllFilenames (list files), readMultipleFiles (read file contents), getOpenTodos (find unchecked todos), and updateFileContent (create/update files).

Where does my data live?

The server reads and writes directly to the markdown files in your Obsidian vault. No external cloud storage is used, and your data stays on your local filesystem.

Comments

More Memory & Knowledge MCP servers