Log inSubmit server
Easy Obsidian MCP logo

Easy Obsidian MCP

by louis030195

Searches, reads, and analyzes local Obsidian vaults through filesystem and optional Local REST API access.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Easy Obsidian MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "louis030195-easy-obsidian-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@louis030195/mcp-obsidian"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

We couldn’t confirm it starts correctly

The install command started, but didn't respond the way we expected when we tried to talk to it.

npx -y @louis030195/mcp-obsidian

initialize succeeded but no response to tools/list.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked .

Overview

The louis030195/easy-obsidian-mcp MCP server connects AI assistants to Obsidian vaults for note search, retrieval, file listing, and relationship analysis. It provides simple text, fuzzy, graph, and Dataview query tools over MCP, with local filesystem access and optional use of Obsidian’s Local REST API for broader features. Reach for it when an agent needs to find notes, inspect metadata, follow backlinks, identify orphaned notes, or query structured vault data. The README provides configuration examples for Claude Desktop, Claude Code, and Cursor.

Use cases

  • Search notes for a topic or phrase
  • Query vault metadata with Dataview DQL
  • Find backlinks and related notes
  • Identify orphaned notes
  • Read files from a selected vault directory

Key features

  • Simple full-vault text search
  • Fuzzy note search
  • Dataview DQL queries
  • File and folder listing
  • Full note content retrieval
  • Graph and backlink analysis

Tools6

What Easy Obsidian MCP lets your agent do. Expand a tool for its parameters.

Verified live~1.4k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked

Recent health check succeeded.

8/8 checks healthy over the last 48d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 9d ago via OSV.dev · @louis030195/mcp-obsidian (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars17Stargazers on the source repository.
npm downloads72Package downloads in the last 30 days.
Last commit1y agoMost recent push to the default branch.
Install checkInconclusiveStarted but did not complete the MCP handshake in our test.
Tools exposed6Callable tools this server registers over MCP.
Directory activity9 viewsConfig copies, upvotes, and views on AllMCPs.

How Easy Obsidian MCP works

What louis030195/easy-obsidian-mcp MCP server does

The louis030195/easy-obsidian-mcp MCP server exposes an Obsidian vault to compatible AI clients through MCP. It is intended for knowledge-management tasks involving local notes, folders, metadata, tags, links, and tasks.

The repository describes support for creating, reading, updating, and searching notes, while the explicitly listed MCP tools cover reading, listing, searching, Dataview queries, and graph analysis. Developers should verify the available tool definitions in the installed package if note mutation is required.

How it works

The server runs locally through the npm package @louis030195/mcp-obsidian, launched with npx. AI clients communicate with it over the MCP server configuration.

Simple search checks file contents for a text query. Fuzzy search is useful when the spelling or wording is uncertain and is described as working even when the Obsidian API is unavailable. Graph search examines links between notes, including orphan detection and relationship discovery, and also works without the API.

Dataview search accepts DQL, Obsidian Dataview’s query language. Queries can filter, sort, group, and transform results using fields such as frontmatter, inline fields, tags, folders, links, file names, paths, dates, and tasks. DQL processing is sequential, so later commands receive the results of earlier commands.

Setup and configuration

The louis030195/easy-obsidian-mcp MCP server can be added to Claude Desktop or Cursor by defining an MCP entry with the npx -y @louis030195/mcp-obsidian command. The README also gives a Claude Code command using the same package.

For the optional full-feature path, install and enable Obsidian’s Community Plugins feature named Local REST API, then place its API key in the OBSIDIAN_API_KEY environment variable. The README marks this API setup as optional. If connection problems occur, check that Obsidian is running, the Local REST API plugin is enabled when needed, and the configured key is correct.

Tools and capabilities

  • obsidian_simple_search searches all vault files for matching text.
  • obsidian_fuzzy_search finds notes using approximate matching.
  • obsidian_dataview_search runs DQL queries over note metadata and relationships.
  • obsidian_get_file_content retrieves the complete content of a specified file.
  • obsidian_list_files lists files and folders at the vault root or within a selected directory.
  • obsidian_graph_search analyzes note links, finds orphaned notes, and builds link relationships.

Together, these tools support searches for tags, folders, backlinks, note titles, and structured metadata. Examples include listing notes from a folder, finding notes linked to a page, and selecting files modified during a period.

Limitations and notes

The tool list does not enumerate a dedicated create-note or update-note operation, despite the broader repository description mentioning create and update interactions. Confirm mutation support before designing workflows that write to a vault. Dataview queries must use DQL syntax rather than SQL syntax. API-dependent behavior may require Obsidian to be running with Local REST API enabled, while fuzzy and graph searches are specifically described as usable without the API.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Easy Obsidian MCP

Configure an MCP client to run `npx -y @louis030195/mcp-obsidian`. The README includes examples for Claude Desktop, Claude Code, and Cursor.

Yes. The README provides a Claude Desktop configuration using the `@louis030195/mcp-obsidian` npm package.

Fuzzy and graph search are described as working without the Obsidian API.

Yes. Its `obsidian_dataview_search` tool executes Obsidian Dataview DQL queries over metadata, tags, folders, links, file properties, and tasks.

Related MCP servers

All in Knowledge & Memory All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewEasy Obsidian MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/louis030195-easy-obsidian-mcp?style=directory)](https://allmcps.com/mcp/louis030195-easy-obsidian-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/louis030195-easy-obsidian-mcp"><img src="https://allmcps.com/api/badge/louis030195-easy-obsidian-mcp?style=directory" alt="Easy Obsidian MCP on AllMCPs" /></a>