How do I install the kp ripgrep mcp server?

Use a recorded configuration for your client, replace example credential values and paths, and verify the documented runtime. Restart or reconnect the client, then inspect the available tools.

What credentials does it need?

It reads `OBSIDIAN_VAULT_PATH` from the environment. Store these in your client's env block or a secrets manager — never commit them to a repository — and grant the narrowest scope that still covers your use case.

SSyncDev

Start a project

Kp Ripgrep MCP Server

This MCP server enables Claude to search file content using ripgrep - with extra features for Obsidian. It understands Obsidian-specific elements

Local serverstdioPython

What is the Kp Ripgrep MCP Server?

This MCP server enables Claude to search file content using ripgrep - with extra features for Obsidian. It understands Obsidian-specific elements like wiki links, frontmatter properties, and provides intelligent context about where matches are found.

Requirements

Python 3.8 or higher - ripgrep installed and available in PATH - An Obsidian vault

Practical notes

Maintained by kpetrovsky, written in Python.

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
rg_search_notes	Search for text content within your notes with flexible scope options. - Search all content, only frontmatter, or only note content - Get smart context showing which frontmatter property or heading contains each match -
rg_search_links	Find and analyze links throughout your vault. - Discover wiki links ([[Note Title]]), markdown links, and external URLs - Filter links by URL patterns or title patterns - Useful for finding broken links or analyzing your
rg_search_backlinks	Find all notes that link to a specific target note. - Identify which notes reference a particular topic or note - Understand the context around each backlink reference - Discover how ideas connect across your vault
rg_search_recent_notes	Find notes modified within specific date ranges. - Search by modification date using YYYY-MM-DD format - Useful for reviewing recent work or finding notes from specific time periods - Combine with other searches to find
rg_search_orphaned_notes	Identify notes that have no incoming or outgoing links. - Find isolated notes that might need better integration - Discover forgotten content that could be connected to your knowledge graph - Useful for vault maintenance

How to install the Kp Ripgrep MCP Server

{
  "mcpServers": {
    "obsidian-search": {
      "command": "python",
      "args": ["-m", "rgrep_mcp.server"],
      "env": {
        "OBSIDIAN_VAULT_PATH": "/path/to/your/obsidian/vault"
      }
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

Python 3.8 or higher - ripgrep installed and available in PATH - An Obsidian vault

Variable	Description	Required
OBSIDIAN_VAULT_PATH	Filesystem location the server is allowed to use.	Optional

Example prompts to try

“Use Kp Ripgrep MCP to rg search notes.”
“Use Kp Ripgrep MCP to rg search links.”
“Use Kp Ripgrep MCP to rg search backlinks.”

Frequently asked questions

This MCP server enables Claude to search file content using ripgrep - with extra features for Obsidian. It understands Obsidian-specific elements like wiki links Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.