MCP.so
Sign In

Obsidian MCP Server

@marcelmarais

About Obsidian MCP Server

No overview available yet

Basic information

Category

Memory & Knowledge

Runtime

node

Transports

stdio

Publisher

marcelmarais

Config

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

{
  "mcpServers": {
    "obsidian-mcp-server-marcelmarais": {
      "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?

A lightweight Model Context Protocol (MCP) server that enables AI assistants like Cursor and Claude to read from and write to your Obsidian vault.

How to use Obsidian MCP Server?

Install with npm install obsidian-mcp-server, then build with npm run build. Add the server to Claude Desktop’s claude_desktop_config.json using node obsidian-mcp-server/build/index.js /path/to/your/vault. In Cursor, go to the MCP tab and add a server with the same command.

Key features of Obsidian MCP Server

  • getAllFilenames – lists all filenames in the vault
  • readMultipleFiles – retrieves file contents with exact or partial name matches
  • getOpenTodos – finds all unchecked todo items (- [ ]) across markdown files
  • updateFileContent – creates or overwrites files, auto‑creating directories
  • Standalone server – no Obsidian application needed for filesystem access

Use cases of Obsidian MCP Server

  • Ask an AI to create a new daily standup note based on recent code changes
  • Query the vault for notes about project ideas
  • List all open todos related to a specific task across notes

FAQ from Obsidian MCP Server

How does this server differ from Obsidian MCP plugin alternatives?

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.

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.

Are there any known limitations?

The server only works with markdown files. The getOpenTodos tool detects lines containing exactly - [ ] (unchecked checkboxes). There is no authentication mechanism since it is a local, user‑launched server.

Comments

More Memory & Knowledge MCP servers