Skip to content
Obsidian

ObsidianMCP Server

by Cal Deacon
Added to Onei
v1.0.0
Repository Docs npm
Files & Storage

Summary

Let an AI client read and search your Obsidian vault — or any folder of Markdown notes.

Features

  • Search across an Obsidian vault by content
  • Read individual notes including frontmatter
  • Works with any directory of Markdown files

Installation

Set up this MCP server in your favorite AI agent — copy a ready-made configuration below.

Any MCP-compatible agent

Most agents (Claude, Cursor, Windsurf, VS Code, and more) read a standard mcpServers configuration.

  1. Open your agent's MCP configuration file.
  2. Merge the snippet below into it.
  3. Restart the agent — the "Obsidian" tools will be available.
{
  "mcpServers": {
    "obsidian": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-obsidian",
        "/path/to/vault"
      ]
    }
  }
}

Description

This MCP server exposes a directory of Markdown files — an Obsidian vault, or any notes folder — to an AI assistant for reading and searching.

What it does
  • Full-text search across every note in the vault, returning matches with context
  • Reading notes by path, including YAML frontmatter and the links and tags within
  • Directory listing so the assistant can navigate a vault's structure
Why it is worth setting up

An Obsidian vault is usually years of accumulated notes: meeting records, research, project histories, and half-finished thinking. Being able to ask questions of that corpus — what did we decide about this, where did I write about that pattern, what have I already read on this topic — is a substantially better interface than search-and-scroll.

It is also excellent context for writing: an assistant that can read your existing notes writes in a way that fits them.

Setup

npx -y mcp-obsidian /path/to/vault. Read-only, which is the right default for a personal knowledge base — nothing gets rewritten without you doing it.

Related MCP Servers

MCP: Notion

by Notion

Notion's official MCP server — search, read, create, and update pages and databases in your workspace.

Productivity

MCP: Engram

by Gentleman Programming

Featured

Persistent memory for coding agents as a single Go binary — SQLite and FTS5 behind MCP, an HTTP API, a CLI and a TUI, with no Node, Python or Docker required.

Developer Tools

MCP: OKF Agent Memory

by okf-memory

Git-native persistent memory for coding agents — sub-300µs BM25 search over version-controlled plain text, with no embeddings, no database and no API costs.

Databases & Data
Browse all MCP servers →