Obsidian Mcp — independently scanned and version-tracked by SaferSkills.
SaferSkills independently audited Obsidian Mcp (Agent Skill) and scored it 100/100 (green). The audit ran 55 deterministic rules across Security, Supply Chain, Maintenance, Transparency, and Community; it found 0 high-severity and 0 lower-severity findings. The full rule-by-rule trace and per-finding evidence are below. Free, methodology-open.
Findings & checks · 0 flagged
Every scanned point with the score it earned and what moved between them.
First recorded scan — no prior version to compare against.
The primary manifest — the file an agent reads to learn what this artifact does.
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.
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.mainThe virtual environment is created automatically by uv inside .venv/. Use .venv/bin/python as the interpreter path in your 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.
| 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. |
| 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. |
~30 seconds. Free. No account. Every finding cites a rule and a line of evidence.