obsidian-mcp-pro 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 [Your Name Here]
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,198 @@
+# obsidian-mcp-pro
+
+**The most feature-complete MCP server for Obsidian vaults.**
+
+[![npm version](https://img.shields.io/npm/v/obsidian-mcp-pro.svg)](https://www.npmjs.com/package/obsidian-mcp-pro)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+[![Node >= 18](https://img.shields.io/badge/node-%3E%3D18-brightgreen.svg)](https://nodejs.org/)
+
+Give AI assistants deep, structured access to your Obsidian knowledge base. Read, write, search, tag, analyze links, traverse graphs, and manipulate canvases — all through the [Model Context Protocol](https://modelcontextprotocol.io/).
+
+---
+
+## Features
+
+### Read & Search
+- Full-text search across all vault notes
+- Read individual notes with frontmatter parsing
+- List and filter notes by folder, date, or pattern
+- Search by frontmatter fields and values
+- Retrieve daily notes automatically
+
+### Write & Modify
+- Create new notes with frontmatter and content
+- Append or prepend content to existing notes
+- Update frontmatter properties programmatically
+- Move and rename notes with automatic link updates
+- Delete notes safely
+
+### Tags
+- Build and query a complete tag index
+- Search notes by single or multiple tags
+
+### Links & Graph
+- Get backlinks (what links *to* a note)
+- Get outlinks (what a note links *to*)
+- Find orphan notes with no inbound or outbound links
+- Detect broken links pointing to non-existent notes
+- Traverse graph neighbors to a configurable depth
+
+### Canvas
+- Read `.canvas` files with full node and edge data
+- Add new nodes (text, file, link, group) to canvases
+- Add edges between canvas nodes
+- List all canvases in the vault
+
+### MCP Resources
+- `obsidian://note/{path}` — read any note by its vault-relative path
+- `obsidian://tags` — retrieve the full tag index as JSON
+- `obsidian://daily` — get today's daily note content
+
+---
+
+## Quick Start
+
+### Claude Desktop
+
+Add this to your Claude Desktop configuration file (`claude_desktop_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "obsidian": {
+      "command": "npx",
+      "args": ["-y", "obsidian-mcp-pro"]
+    }
+  }
+}
+```
+
+If you have multiple vaults, specify which one:
+
+```json
+{
+  "mcpServers": {
+    "obsidian": {
+      "command": "npx",
+      "args": ["-y", "obsidian-mcp-pro"],
+      "env": {
+        "OBSIDIAN_VAULT_PATH": "/path/to/your/vault"
+      }
+    }
+  }
+}
+```
+
+### Claude Code
+
+```bash
+claude mcp add obsidian-mcp-pro -- npx -y obsidian-mcp-pro
+```
+
+---
+
+## Configuration
+
+The server locates your vault using the following priority:
+
+| Priority | Method | Description |
+|----------|--------|-------------|
+| 1 | `OBSIDIAN_VAULT_PATH` | Environment variable with the absolute path to your vault |
+| 2 | `OBSIDIAN_VAULT_NAME` | Environment variable to select a vault by folder name when multiple vaults exist |
+| 3 | Auto-detection | Reads Obsidian's global config (`obsidian.json`) and uses the first valid vault found |
+
+Auto-detection works on **macOS**, **Windows**, and **Linux** by reading the platform-specific Obsidian configuration directory.
+
+---
+
+## Tool Reference
+
+| Tool | Description | Key Parameters |
+|------|-------------|----------------|
+| `search_notes` | Full-text search across all notes | `query`, `caseSensitive`, `maxResults`, `folder` |
+| `get_note` | Read a note's content and metadata | `path` |
+| `list_notes` | List notes in the vault or a folder | `folder`, `pattern`, `recursive` |
+| `get_daily_note` | Get today's (or a specific date's) daily note | `date` |
+| `search_by_frontmatter` | Find notes by frontmatter field values | `field`, `value`, `operator` |
+| `create_note` | Create a new note with content and frontmatter | `path`, `content`, `frontmatter` |
+| `append_to_note` | Append content to an existing note | `path`, `content` |
+| `prepend_to_note` | Prepend content after frontmatter | `path`, `content` |
+| `update_frontmatter` | Update frontmatter fields on a note | `path`, `fields` |
+| `create_daily_note` | Create today's daily note from template | `date`, `content` |
+| `move_note` | Move or rename a note | `source`, `destination` |
+| `delete_note` | Delete a note from the vault | `path`, `confirm` |
+| `get_tags` | Get all tags and their usage counts | `sort` |
+| `search_by_tag` | Find all notes with a specific tag | `tag`, `includeChildren` |
+| `get_backlinks` | Get all notes that link to a given note | `path` |
+| `get_outlinks` | Get all links from a given note | `path` |
+| `find_orphans` | Find notes with no links in or out | `folder` |
+| `find_broken_links` | Detect links pointing to non-existent notes | `folder` |
+| `get_graph_neighbors` | Get notes connected within N link hops | `path`, `depth` |
+| `read_canvas` | Read a `.canvas` file's nodes and edges | `path` |
+| `add_canvas_node` | Add a node to a canvas | `canvasPath`, `type`, `x`, `y`, `width`, `height` |
+| `list_canvases` | List all `.canvas` files in the vault | `folder` |
+| `add_canvas_edge` | Add an edge between two canvas nodes | `canvasPath`, `fromNode`, `toNode` |
+
+---
+
+## MCP Resources
+
+Resources provide a URI-based way to access vault data:
+
+| Resource URI | Description |
+|-------------|-------------|
+| `obsidian://note/{path}` | Read any note by its vault-relative path |
+| `obsidian://tags` | Full tag index with file lists (JSON) |
+| `obsidian://daily` | Today's daily note content |
+
+---
+
+## Development
+
+```bash
+# Clone the repository
+git clone https://github.com/your-username/obsidian-mcp-pro.git
+cd obsidian-mcp-pro
+
+# Install dependencies
+npm install
+
+# Build
+npm run build
+
+# Run in development (watch mode)
+npm run dev
+
+# Start the server locally
+OBSIDIAN_VAULT_PATH=/path/to/vault npm start
+```
+
+### Project Structure
+
+```
+src/
+  index.ts          # Server entry point and resource registration
+  config.ts         # Vault detection and configuration
+  types.ts          # Shared TypeScript interfaces
+  lib/
+    vault.ts        # Core vault operations (read, search, list)
+    markdown.ts     # Frontmatter parsing and tag extraction
+  tools/
+    read.ts         # Search, get, list, daily note tools
+    write.ts        # Create, append, prepend, update, move, delete tools
+    tags.ts         # Tag index and tag search tools
+    links.ts        # Backlinks, outlinks, orphans, broken links, graph tools
+    canvas.ts       # Canvas read, node, edge, and list tools
+```
+
+---
+
+## License
+
+MIT
+
+---
+
+## Contributing
+
+Contributions welcome! Please open an issue first to discuss what you'd like to change. Pull requests without a corresponding issue may be closed.

package/build/config.d.ts

@@ -0,0 +1,4 @@
+import type { VaultConfig, DailyNoteConfig } from "./types.js";
+export declare function getVaultConfig(): VaultConfig;
+export declare function getDailyNoteConfig(vaultPath?: string): DailyNoteConfig;
+//# sourceMappingURL=config.d.ts.map

package/build/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAgJ/D,wBAAgB,cAAc,IAAI,WAAW,CAsB5C;AAED,wBAAgB,kBAAkB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,eAAe,CAiCtE"}

package/build/config.js

@@ -0,0 +1,147 @@
+import * as fs from "fs";
+import * as path from "path";
+import * as os from "os";
+function getObsidianConfigPath() {
+    const platform = os.platform();
+    if (platform === "win32") {
+        const appData = process.env.APPDATA;
+        if (!appData) {
+            throw new Error("APPDATA environment variable is not set");
+        }
+        return path.join(appData, "obsidian", "obsidian.json");
+    }
+    if (platform === "darwin") {
+        return path.join(os.homedir(), "Library", "Application Support", "obsidian", "obsidian.json");
+    }
+    // Linux and other Unix-like systems
+    return path.join(os.homedir(), ".config", "obsidian", "obsidian.json");
+}
+function isValidVaultPath(vaultPath) {
+    try {
+        const obsidianDir = path.join(vaultPath, ".obsidian");
+        return (fs.existsSync(vaultPath) &&
+            fs.statSync(vaultPath).isDirectory() &&
+            fs.existsSync(obsidianDir) &&
+            fs.statSync(obsidianDir).isDirectory());
+    }
+    catch {
+        return false;
+    }
+}
+function resolveVaultFromEnv() {
+    const envPath = process.env.OBSIDIAN_VAULT_PATH;
+    if (!envPath) {
+        return null;
+    }
+    const resolved = path.resolve(envPath);
+    if (!isValidVaultPath(resolved)) {
+        console.error(`OBSIDIAN_VAULT_PATH is set to "${resolved}" but it does not contain a valid Obsidian vault (.obsidian directory missing)`);
+        return null;
+    }
+    return resolved;
+}
+function resolveVaultFromObsidianConfig() {
+    let configPath;
+    try {
+        configPath = getObsidianConfigPath();
+    }
+    catch (err) {
+        console.error(`Failed to determine Obsidian config path: ${err}`);
+        return null;
+    }
+    if (!fs.existsSync(configPath)) {
+        console.error(`Obsidian config not found at ${configPath}`);
+        return null;
+    }
+    let config;
+    try {
+        const raw = fs.readFileSync(configPath, "utf-8");
+        config = JSON.parse(raw);
+    }
+    catch (err) {
+        console.error(`Failed to parse Obsidian config at ${configPath}: ${err}`);
+        return null;
+    }
+    if (!config.vaults || typeof config.vaults !== "object") {
+        console.error("No vaults found in Obsidian config");
+        return null;
+    }
+    const vaultEntries = Object.values(config.vaults);
+    if (vaultEntries.length === 0) {
+        console.error("Obsidian config contains no vault entries");
+        return null;
+    }
+    const desiredName = process.env.OBSIDIAN_VAULT_NAME;
+    if (desiredName) {
+        const matched = vaultEntries.find((entry) => {
+            const vaultName = path.basename(entry.path);
+            return vaultName === desiredName;
+        });
+        if (matched) {
+            const resolved = path.resolve(matched.path);
+            if (isValidVaultPath(resolved)) {
+                return resolved;
+            }
+            console.error(`Vault "${desiredName}" found in config but path "${resolved}" is not a valid vault`);
+            return null;
+        }
+        console.error(`OBSIDIAN_VAULT_NAME is set to "${desiredName}" but no matching vault was found in Obsidian config`);
+        return null;
+    }
+    // No name specified — try the first valid vault
+    for (const entry of vaultEntries) {
+        const resolved = path.resolve(entry.path);
+        if (isValidVaultPath(resolved)) {
+            if (vaultEntries.length > 1) {
+                console.error(`Multiple vaults found. Using "${path.basename(resolved)}". Set OBSIDIAN_VAULT_NAME to select a specific vault.`);
+            }
+            return resolved;
+        }
+    }
+    console.error("No valid vault paths found in Obsidian config");
+    return null;
+}
+export function getVaultConfig() {
+    // Priority 1: environment variable
+    const envVault = resolveVaultFromEnv();
+    if (envVault) {
+        return {
+            vaultPath: envVault,
+            configPath: path.join(envVault, ".obsidian"),
+        };
+    }
+    // Priority 2: auto-detect from Obsidian's global config
+    const detectedVault = resolveVaultFromObsidianConfig();
+    if (detectedVault) {
+        return {
+            vaultPath: detectedVault,
+            configPath: path.join(detectedVault, ".obsidian"),
+        };
+    }
+    throw new Error("Unable to find an Obsidian vault. Set OBSIDIAN_VAULT_PATH environment variable or ensure Obsidian is installed with at least one vault configured.");
+}
+export function getDailyNoteConfig(vaultPath) {
+    const defaults = {
+        folder: "",
+        format: "YYYY-MM-DD",
+    };
+    const resolvedVaultPath = vaultPath ?? getVaultConfig().vaultPath;
+    const dailyNotesConfigPath = path.join(resolvedVaultPath, ".obsidian", "daily-notes.json");
+    if (!fs.existsSync(dailyNotesConfigPath)) {
+        return defaults;
+    }
+    try {
+        const raw = fs.readFileSync(dailyNotesConfigPath, "utf-8");
+        const parsed = JSON.parse(raw);
+        return {
+            folder: typeof parsed.folder === "string" ? parsed.folder : defaults.folder,
+            format: typeof parsed.format === "string" ? parsed.format : defaults.format,
+            template: typeof parsed.template === "string" ? parsed.template : undefined,
+        };
+    }
+    catch (err) {
+        console.error(`Failed to parse daily notes config at ${dailyNotesConfigPath}: ${err}`);
+        return defaults;
+    }
+}
+//# sourceMappingURL=config.js.map

package/build/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}

package/build/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/build/index.js

@@ -0,0 +1,135 @@
+#!/usr/bin/env node
+import * as fs from "fs";
+import * as path from "path";
+import { McpServer, ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { getVaultConfig, getDailyNoteConfig } from "./config.js";
+import { registerReadTools } from "./tools/read.js";
+import { registerWriteTools } from "./tools/write.js";
+import { registerTagTools } from "./tools/tags.js";
+import { registerLinkTools } from "./tools/links.js";
+import { registerCanvasTools } from "./tools/canvas.js";
+async function main() {
+    let vaultPath;
+    try {
+        const config = getVaultConfig();
+        vaultPath = config.vaultPath;
+    }
+    catch (err) {
+        console.error(`[obsidian-mcp-pro] Failed to detect vault: ${err}`);
+        process.exit(1);
+    }
+    const server = new McpServer({
+        name: "obsidian-mcp-pro",
+        version: "1.0.0",
+    });
+    // --- MCP Resources ---
+    server.resource("note", new ResourceTemplate("obsidian://note/{path}", { list: undefined }), async (uri, params) => {
+        const rawPath = params.path;
+        const notePath = Array.isArray(rawPath) ? rawPath[0] : (rawPath ?? "");
+        const fullPath = path.join(vaultPath, notePath);
+        if (!fs.existsSync(fullPath)) {
+            throw new Error(`Note not found: ${notePath}`);
+        }
+        const content = fs.readFileSync(fullPath, "utf-8");
+        return {
+            contents: [
+                {
+                    uri: uri.href,
+                    mimeType: "text/markdown",
+                    text: content,
+                },
+            ],
+        };
+    });
+    server.resource("tags", "obsidian://tags", async (uri) => {
+        const tagIndex = {};
+        const walkDir = (dir) => {
+            const entries = fs.readdirSync(dir, { withFileTypes: true });
+            for (const entry of entries) {
+                if (entry.name.startsWith("."))
+                    continue;
+                const fullPath = path.join(dir, entry.name);
+                if (entry.isDirectory()) {
+                    walkDir(fullPath);
+                }
+                else if (entry.name.endsWith(".md")) {
+                    const content = fs.readFileSync(fullPath, "utf-8");
+                    const relativePath = path.relative(vaultPath, fullPath);
+                    const tags = content.match(/#[a-zA-Z][\w/-]*/g) ?? [];
+                    for (const tag of tags) {
+                        if (!tagIndex[tag]) {
+                            tagIndex[tag] = [];
+                        }
+                        tagIndex[tag].push(relativePath);
+                    }
+                }
+            }
+        };
+        walkDir(vaultPath);
+        return {
+            contents: [
+                {
+                    uri: uri.href,
+                    mimeType: "application/json",
+                    text: JSON.stringify(tagIndex, null, 2),
+                },
+            ],
+        };
+    });
+    server.resource("daily", "obsidian://daily", async (uri) => {
+        const dailyConfig = getDailyNoteConfig(vaultPath);
+        const today = new Date();
+        const year = today.getFullYear();
+        const month = String(today.getMonth() + 1).padStart(2, "0");
+        const day = String(today.getDate()).padStart(2, "0");
+        // Build the filename from the configured format
+        let filename = dailyConfig.format
+            .replace("YYYY", String(year))
+            .replace("MM", month)
+            .replace("DD", day);
+        if (!filename.endsWith(".md")) {
+            filename += ".md";
+        }
+        const dailyNotePath = dailyConfig.folder
+            ? path.join(vaultPath, dailyConfig.folder, filename)
+            : path.join(vaultPath, filename);
+        if (!fs.existsSync(dailyNotePath)) {
+            return {
+                contents: [
+                    {
+                        uri: uri.href,
+                        mimeType: "text/markdown",
+                        text: `No daily note found for today (expected at ${path.relative(vaultPath, dailyNotePath)})`,
+                    },
+                ],
+            };
+        }
+        const content = fs.readFileSync(dailyNotePath, "utf-8");
+        return {
+            contents: [
+                {
+                    uri: uri.href,
+                    mimeType: "text/markdown",
+                    text: content,
+                },
+            ],
+        };
+    });
+    // --- Register tool groups ---
+    registerReadTools(server, vaultPath);
+    registerWriteTools(server, vaultPath);
+    registerTagTools(server, vaultPath);
+    registerLinkTools(server, vaultPath);
+    registerCanvasTools(server, vaultPath);
+    // --- Connect transport ---
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error(`[obsidian-mcp-pro] Server started`);
+    console.error(`[obsidian-mcp-pro] Vault: ${vaultPath}`);
+}
+main().catch((err) => {
+    console.error(`[obsidian-mcp-pro] Fatal error: ${err}`);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/build/lib/markdown.d.ts

@@ -0,0 +1,43 @@
+import type { NoteMetadata, LinkInfo } from "../types.js";
+/**
+ * Parse YAML frontmatter from markdown content.
+ */
+export declare function parseFrontmatter(content: string): {
+    data: Record<string, unknown>;
+    content: string;
+};
+/**
+ * Parse existing frontmatter, merge with updates, and return full content
+ * with updated frontmatter. Creates frontmatter if none exists.
+ */
+export declare function updateFrontmatter(content: string, updates: Record<string, unknown>): string;
+/**
+ * Extract all wikilinks and embeds from markdown content.
+ * Ignores links inside code blocks and inline code.
+ */
+export declare function extractWikilinks(content: string): LinkInfo[];
+/**
+ * Extract inline tags and frontmatter tags from markdown content.
+ * Returns deduplicated tags without the `#` prefix.
+ * Ignores tags inside code blocks and inline code.
+ */
+export declare function extractTags(content: string): string[];
+/**
+ * Extract aliases from frontmatter `aliases` field.
+ */
+export declare function extractAliases(content: string): string[];
+/**
+ * Build a complete NoteMetadata object from a note's content and file stats.
+ */
+export declare function buildNoteMetadata(vaultPath: string, relativePath: string, content: string, stats: {
+    size: number;
+    created: Date | null;
+    modified: Date | null;
+}): NoteMetadata;
+/**
+ * Resolve a wikilink target to an actual file path using Obsidian's
+ * shortest-path matching strategy.
+ * Returns null if no match is found.
+ */
+export declare function resolveWikilink(link: string, _currentNotePath: string, allNotePaths: string[]): string | null;
+//# sourceMappingURL=markdown.d.ts.map

package/build/lib/markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../src/lib/markdown.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE1D;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG;IACjD,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;CACjB,CAMA;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,MAAM,CAIR;AA0BD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,EAAE,CAqC5D;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAqCrD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAgBxD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,IAAI,GAAG,IAAI,CAAC;IAAC,QAAQ,EAAE,IAAI,GAAG,IAAI,CAAA;CAAE,GACnE,YAAY,CAsBd;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,gBAAgB,EAAE,MAAM,EACxB,YAAY,EAAE,MAAM,EAAE,GACrB,MAAM,GAAG,IAAI,CA6Cf"}