Notes MCP Server

Notes MCP Server is an MCP server that connects AI assistants to an Obsidian knowledge base. Built using Deno and the Model Context Protocol, it allows developers, researchers, and knowledge workers to query and retrieve their local Obsidian vault files directly within supported AI tools. The server implements tools for full-text search and file reading. Search functionality relies on ripgrep, supporting custom patterns and flags to locate relevant files quickly. When reading notes, the server parses markdown content, separates and extracts YAML frontmatter into structured JSON metadata, and identifies inline Obsidian tags. By exposing these tools over MCP, the server enables language models such as Claude to incorporate personal notes, daily logs, and documentation into context without manual copying and pasting. It runs cross-platform on Windows, macOS, and Linux systems.

Category: Files, Documents & PDFs

Tags: knowledge-management, markdown, notes, obsidian

Visit Notes MCP Server

How to install and configure Notes MCP Server

1. Ensure you have Deno and ripgrep (rg) installed on your system. 2. Clone the repository from https://github.com/boazy/notes-mcp to a local directory. 3. Open your Claude Desktop configuration file (~/.config/claude/claude_desktop_config.json on macOS/Linux or %APPDATA%\Claude\claude_desktop_config.json on Windows). 4. Add the server entry under mcpServers: json { "mcpServers": { "notes": { "command": "deno", "args": [ "run", "--allow-read=/path/to/your/obsidian/vault", "--allow-run=rg", "--allow-env=OBSIDIAN_VAULT_PATH", "src/index.ts" ], "cwd": "/path/to/notes-mcp", "env": { "OBSIDIAN_VAULT_PATH": "/path/to/your/obsidian/vault" } } } } 5. Replace /path/to/notes-mcp and /path/to/your/obsidian/vault with your actual paths. 6. Restart Claude Desktop.

What you can do with Notes MCP Server

• Querying project documentation across markdown files using ripgrep patterns and flags directly from an LLM prompt. - Extracting structured YAML frontmatter and Obsidian tags to organize and categorize personal research notes. - Reading specific daily notes to summarize activities, decisions, and progress during team standup meetings. - Searching vault contents to retrieve relevant context when drafting articles, proposals, or technical specs.

Key facts

• Open Source
• https://github.com/boazy/notes-mcp
• Files, Documents & PDFs, Notes & Knowledge Management
• knowledge-management, markdown, notes, obsidian

Part of MCP Servers

What is Notes MCP Server?

Notes MCP Server is a Model Context Protocol server that connects AI clients like Claude Desktop to an Obsidian vault. It provides tools to search vault files with ripgrep and parse markdown notes including their metadata and tags.

What prerequisites are required to run Notes MCP Server?

Running the server requires the Deno runtime, the ripgrep command-line utility, and a local Obsidian vault directory containing markdown files. The path to the vault must be defined in the OBSIDIAN_VAULT_PATH environment variable.

What tools does Notes MCP Server provide?

The server provides two main tools: search_notes and read_notes. The search_notes tool uses ripgrep to perform fast full-text searches across markdown files, while read_notes retrieves content, frontmatter metadata, and tags from specified paths.

Which MCP clients work with Notes MCP Server?

Notes MCP Server works with any standard MCP client, including Claude Desktop on macOS, Linux, and Windows. It can also be tested locally using its included query command-line interface tool.

Is Notes MCP Server open source?

Yes, Notes MCP Server is open source. The complete source code, development scripts, and documentation are hosted publicly on GitHub at https://github.com/boazy/notes-mcp.