Notes MCP Server

An MCP server for interacting with Obsidian notes. Requires the OBSIDIAN_VAULT_PATH environment variable to be set.

An MCP (Model Context Protocol) server for interacting with Obsidian notes. This server provides tools to search through and read notes from your Obsidian vault, making your knowledge base accessible to AI assistants.

- Search Notes: Full-text search through your Obsidian vault using ripgrep
- Read Notes: Parse and extract content, metadata, and tags from notes
- Cross-platform: Works on Windows, macOS, and Linux
- Frontmatter Support: Extracts YAML frontmatter as structured metadata
- Tag Extraction: Automatically identifies and extracts Obsidian tags

- Denoruntime
- ripgrep(rgcommand)
- An Obsidian vault with markdown files
- Clone or download this project
- Set theOBSIDIAN_VAULT_PATHenvironment variable:

export OBSIDIAN_VAULT_PATH="/path/to/your/obsidian/vault"

# Using Deno directly deno task start # Using mise (if you have mise installed) mise run start

# Using Deno deno task dev # Using mise mise run dev

# Search for notes containing a pattern (case-insensitive by default) mise run query search "productivity" # Case-sensitive search mise run query search "TODO" --case-sensitive # Search for whole words only mise run query search "test" --whole-word # Multiline search mise run query search "pattern.spans.lines" --multiline # Search with custom context lines (default: 5) mise run query search "pattern" --context 10 # Read specific notes mise run query read "daily-notes/2024-01-15" mise run query read "note1" "folder/note2" # Use verbose mode to see the request being sent mise run query -v search "pattern" mise run query --verbose read "note1"

// Search for notes containing "productivity" await search_notes({ pattern: "productivity", flags: ["-i"] // case-insensitive }); // Read specific notes await read_notes({ paths: ["daily-notes/2024-01-15", "projects/my-project"] });

The server requires theOBSIDIAN_VAULT_PATHenvironment variable to be set to your Obsidian vault directory.

To use this MCP server with Claude Desktop, add it to your Claude configuration file:

macOS/Linux:~/.config/claude/claude_desktop_config.jsonWindows:%APPDATA%\Claude\claude_desktop_config.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" } } } }

Using mise (recommended if you have mise installed):

{ "mcpServers": { "notes": { "command": "/path/to/notes-mcp/start-server.sh", "env": { "OBSIDIAN_VAULT_PATH": "/path/to/your/obsidian/vault" } } } }

This uses the includedstart-server.shscript which handles changing to the project directory and runningmise run start.

- /path/to/notes-mcp: The absolute path to this project directory
- /path/to/your/obsidian/vault: The absolute path to your Obsidian vault

After updating the configuration, restart Claude Desktop. The server will appear as "notes" and provide thesearch_notesandread_notestools.

MCP server for Apple Notes with semantic search and CRUD operations. Claude searches, reads, creates, updates, and manages your Apple Notes through natural language.

Integrates Model Context Protocol (MCP) with Obsidian, allowing AI assistants to interact with your notes and vault.

A Model Context Protocol (MCP) Server for https://joplinapp.org/ that enables note access through the https://modelcontextprotocol.io. Perfect for integration with AI assistants like Claude.

A service for reading, writing, and managing markdown documentation with frontmatter metadata.

Connect your AI assistant to your personal knowledge base. Search, save links, create notes and to-dos. AI processes everything automatically.

Interact with your Obsidian vault using natural language.

Interact with your Obsidian vault using the Local REST API plugin, enabling LLMs to access and manage your notes.

Interact with your Obsidian notes and vaults using the Local REST API plugin.

A server for interacting with your Obsidian vault.

Interact with Obsidian vaults to read, create, edit, and manage notes and tags.