MCP.so
Sign In

Obsidian MCP Server

@marcelmarais

Repository

About Obsidian MCP Server

No overview available yet

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.

Frequently asked questions

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

Basic information

Category

Memory & Knowledge

Transports

stdio

Author

marcelmarais

More Memory & Knowledge MCP servers

Memory

modelcontextprotocol

Model Context Protocol Servers

88.1K

Notion MCP Integration

danhilse

A simple MCP integration that allows Claude to read and manage a personal Notion todo list

208

Anytype MCP Server

anyproto

An MCP server enabling AI assistants to interact with Anytype - your encrypted, local and collaborative wiki - to organize objects, lists, and more through natural language.

467

JupyterMCP - Jupyter Notebook Model Context Protocol Integration

jjsantos01

A Model Context Protocol (MCP) for Jupyter Notebook

130

Zettelkasten MCP Server

entanglr

A Model Context Protocol (MCP) server that implements the Zettelkasten knowledge management methodology, allowing you to create, link, explore and synthesize atomic notes through Claude and other MCP-compatible clients.

159