obsidian_mcp

Obsidian MCP Server

Have been using obsidian for quite awhile (have years and years of notes in my vault(have years and years of notes in my vault(have years and years of notes in my vault(have years and years of notes in my vault(have years and years of notes in my vault(have years and years of notes in my vault(have years and years of notes in my vault(have years and years of notes in my vault(have years and years of notes in my vault) and thought we could benefit from some kind of MCP server.

This can be used to read notes from your vault, have AI agents create notes, etc.

Will periodically add more tools and enhancements to this...

Note: This is meant to be used locally or hosted yourself for now. This MCP server currently does not come with an AKS deployment or anything like that. Your vault should ideally also be local (unless you're using some weird plugin), so don't see this as a serious downside.

Setup

Install dependencies

Requires uv. Clone the repo, then:

# Install runtime dependencies
uv sync -p $(cat ./.python-version)

# Install with test extras
uv sync --extra test

# Install with dev extras
uv sync --extra dev

# Run tests
uv run pytest

# Run the server directly
uv run python -m obsidian_mcp.main

The virtual environment is created automatically by uv inside .venv/. Use .venv/bin/python as the interpreter path in your MCP client config.

MCP client config

{
   "mcpServers":{
      "obsidian_mcp":{
         "command":"/<path_to_project>/.venv/bin/python",
         "args": ["-m", "obsidian_mcp.main"],
         "env":{
            "OBSIDIAN_VAULT__PATH": "<local vault path>",
            "OBSIDIAN_LOGGING__LEVEL": "INFO",
            "OBSIDIAN_LOGGING__FORMAT": "%(asctime)s | %(levelname)-8s | %(name)s | %(message)s",
            "OBSIDIAN_SERVER__HOST": "127.0.0.1",
            "OBSIDIAN_SERVER__PORT": 8000,
            "OBSIDIAN_VAULT__ENABLE_WIKILINKS": "True",
            "OBSIDIAN_VAULT__ENABLE_FRONTMATTER": "True",
            "OBSIDIAN_SEARCH__ENABLED": "True",
            "OBSIDIAN_SEARCH__MAX_RESULTS": 100
         }
      }
   }
}

Note: If you have <project_dir>/.env file populated. You can remove these entries in the mcp config. The config class should load the .env.

Tools

| Tool | Description | |------|-------------| | list_notes | List all notes in the vault or a subdirectory. Optionally exclude .obsidian/ and .trash/ (both excluded by default). | | get_note | Read a note by its vault-relative path. Returns path, title, tags, frontmatter, and body. | | search_notes | Search notes for a literal query string. Supports case sensitivity, frontmatter inclusion, and excluding .obsidian//.trash/. | | create_note | Create a new note at a given vault-relative path with optional YAML frontmatter. | | append_to_note | Append text to the end of an existing note without overwriting it. | | update_note | Overwrite the body of an existing note, optionally replacing its frontmatter. | | get_links | Return all outgoing wikilink targets from a note's body. | | get_backlinks | Return all notes in the vault that contain a wikilink pointing to the given note. |

Prompts

| Prompt | Description | |--------|-------------| | summarize_note | Fetches a note by path and returns a structured prompt asking the LLM for a TL;DR, key-point bullets, and any action items or decisions. |