@aniketbiswas/obsidian-mcp-server 1.0.0

package/build/resources/obsidian.js

@@ -0,0 +1,246 @@
+/**
+ * ============================================================================
+ * OBSIDIAN MCP - Resources
+ * ============================================================================
+ *
+ * MCP Resources provide read-only data that AI can access.
+ * These resources provide vault information and status data.
+ * ============================================================================
+ */
+import { CONFIG_DOCS } from "../utils/config.js";
+/**
+ * Register Obsidian resources with the MCP server.
+ *
+ * @param server - The MCP server instance
+ * @param client - The Obsidian API client (or null if not configured)
+ */
+export function registerObsidianResources(server, client) {
+    // ---------------------------------------------------------------------------
+    // RESOURCE: obsidian-status
+    // ---------------------------------------------------------------------------
+    // Provides connection status and configuration info.
+    // ---------------------------------------------------------------------------
+    server.resource("obsidian-status", "mcp://obsidian/status", {
+        description: "Obsidian connection status and configuration information",
+        mimeType: "application/json",
+    }, async (uri) => {
+        let status;
+        if (!client) {
+            status = {
+                connected: false,
+                configured: false,
+                message: "Obsidian is not configured. Set OBSIDIAN_API_KEY environment variable.",
+            };
+        }
+        else {
+            try {
+                const serverStatus = await client.getServerStatus();
+                status = {
+                    connected: serverStatus.authenticated,
+                    configured: true,
+                    obsidianVersion: serverStatus.versions.obsidian,
+                    apiVersion: serverStatus.versions.self,
+                    service: serverStatus.service,
+                };
+            }
+            catch (error) {
+                status = {
+                    connected: false,
+                    configured: true,
+                    error: error instanceof Error ? error.message : String(error),
+                    message: "Failed to connect to Obsidian. Make sure it's running with Local REST API enabled.",
+                };
+            }
+        }
+        return {
+            contents: [
+                {
+                    uri: uri.href,
+                    mimeType: "application/json",
+                    text: JSON.stringify(status, null, 2),
+                },
+            ],
+        };
+    });
+    // ---------------------------------------------------------------------------
+    // RESOURCE: obsidian-help
+    // ---------------------------------------------------------------------------
+    // Provides documentation and available tools list.
+    // ---------------------------------------------------------------------------
+    server.resource("obsidian-help", "mcp://obsidian/help", {
+        description: "Documentation and help for the Obsidian MCP server",
+        mimeType: "text/markdown",
+    }, async (uri) => ({
+        contents: [
+            {
+                uri: uri.href,
+                mimeType: "text/markdown",
+                text: `# Obsidian MCP Server
+
+This MCP server provides tools for interacting with your Obsidian vault through any MCP-compatible AI assistant.
+
+## Prerequisites
+
+1. **Obsidian** must be running
+2. **Local REST API plugin** must be installed and enabled
+3. **API Key** must be configured via environment variable
+
+## Configuration
+
+\`\`\`
+${CONFIG_DOCS}
+\`\`\`
+
+## Available Tool Categories
+
+### Vault Management
+- \`vault_status\` - Check connection status
+- \`list_files\` - List files in a directory
+- \`list_all_files\` - Recursively list all files
+- \`get_vault_structure\` - Get folder tree structure
+- \`get_file_stats\` - Get vault statistics
+
+### Note Operations
+- \`read_note\` - Read note content
+- \`create_note\` - Create a new note
+- \`update_note\` - Update note content
+- \`append_to_note\` - Append to a note
+- \`prepend_to_note\` - Prepend to a note
+- \`insert_under_heading\` - Insert under specific heading
+- \`replace_in_note\` - Find and replace text
+- \`delete_note\` - Delete a note
+- \`copy_note\` - Copy a note
+
+### Search
+- \`search_notes\` - Full-text search with Obsidian syntax
+- \`simple_search\` - Simple text search
+- \`search_by_tag\` - Find notes by tags
+- \`search_in_folder\` - Search within a folder
+- \`find_notes_by_name\` - Find by filename
+- \`search_with_context\` - Search with content snippets
+
+### Metadata & Tags
+- \`get_frontmatter\` - Get note frontmatter
+- \`update_frontmatter\` - Update frontmatter properties
+- \`set_frontmatter_property\` - Set single property
+- \`get_tags\` - Get all tags from a note
+- \`add_tags\` - Add tags to a note
+- \`remove_tags\` - Remove tags from a note
+- \`add_aliases\` - Add note aliases
+- \`get_all_tags_in_vault\` - Get all tags in vault
+
+### Navigation & Commands
+- \`open_note\` - Open note in Obsidian
+- \`get_active_note\` - Get currently active note
+- \`append_to_active_note\` - Append to active note
+- \`get_commands\` - List Obsidian commands
+- \`execute_command\` - Execute a command
+- \`quick_capture\` - Quick capture to inbox
+
+### Daily & Periodic Notes
+- \`get_daily_note\` - Get today's daily note
+- \`append_to_daily_note\` - Append to daily note
+- \`get_periodic_note\` - Get periodic note
+- \`append_to_periodic_note\` - Append to periodic note
+- \`daily_journal_entry\` - Add journal entry
+- \`daily_standup\` - Add standup entry
+
+### Link Analysis
+- \`get_outgoing_links\` - Get links from a note
+- \`get_backlinks\` - Find backlinks to a note
+- \`find_broken_links\` - Find broken links
+- \`find_orphan_notes\` - Find unlinked notes
+- \`add_link_to_note\` - Add a link to a note
+- \`get_link_graph_data\` - Get graph visualization data
+
+### Templates
+- \`create_note_from_template\` - Create from template
+- \`create_meeting_note\` - Create meeting note
+- \`create_project_note\` - Create project note
+- \`list_templates\` - List available templates
+
+## Examples
+
+### Create a new note
+"Create a note called 'Meeting Notes' in the Meetings folder with today's date"
+
+### Search vault
+"Search for notes about machine learning"
+"Find all notes tagged with #project"
+
+### Daily notes
+"Add this task to today's daily note"
+"Create a journal entry with today's highlights"
+
+### Analyze links
+"Find all notes that link to my 'Project Overview' note"
+"Show me orphan notes that need to be linked"
+
+## Tips
+
+- Use wikilinks format: \`[[Note Name]]\` for internal links
+- Tags can be in frontmatter or inline: \`#tag\`
+- Obsidian search syntax works in \`search_notes\`
+- Daily notes require the Daily Notes core plugin
+`,
+            },
+        ],
+    }));
+    // ---------------------------------------------------------------------------
+    // RESOURCE: obsidian-vault-info
+    // ---------------------------------------------------------------------------
+    // Provides vault structure information.
+    // ---------------------------------------------------------------------------
+    if (client) {
+        server.resource("obsidian-vault-info", "mcp://obsidian/vault-info", {
+            description: "Information about the Obsidian vault structure",
+            mimeType: "application/json",
+        }, async (uri) => {
+            try {
+                const allFiles = await client.listAllFiles("", 5);
+                const mdFiles = allFiles.filter((f) => f.type === "file" && f.extension === "md");
+                const directories = allFiles.filter((f) => f.type === "directory");
+                // Count by extension
+                const extensionCounts = {};
+                for (const file of allFiles.filter((f) => f.type === "file")) {
+                    const ext = file.extension || "no-extension";
+                    extensionCounts[ext] = (extensionCounts[ext] || 0) + 1;
+                }
+                const info = {
+                    totalFiles: allFiles.filter((f) => f.type === "file").length,
+                    markdownNotes: mdFiles.length,
+                    directories: directories.length,
+                    extensionCounts,
+                    topLevelFolders: directories
+                        .filter((d) => !d.path.includes("/"))
+                        .map((d) => d.name)
+                        .slice(0, 20),
+                };
+                return {
+                    contents: [
+                        {
+                            uri: uri.href,
+                            mimeType: "application/json",
+                            text: JSON.stringify(info, null, 2),
+                        },
+                    ],
+                };
+            }
+            catch (error) {
+                return {
+                    contents: [
+                        {
+                            uri: uri.href,
+                            mimeType: "application/json",
+                            text: JSON.stringify({
+                                error: error instanceof Error ? error.message : String(error),
+                            }, null, 2),
+                        },
+                    ],
+                };
+            }
+        });
+    }
+    console.error("✅ Obsidian resources registered");
+}
+//# sourceMappingURL=obsidian.js.map

package/build/resources/obsidian.js.map

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

package/build/tools/_template.d.ts

@@ -0,0 +1,23 @@
+/**
+ * ============================================================================
+ * TOOL TEMPLATE - Copy This File to Create Your Own Tools!
+ * ============================================================================
+ *
+ * QUICK START:
+ * 1. Copy this file: cp src/tools/_template.ts src/tools/my-tools.ts
+ * 2. Rename the function: registerTemplateTools → registerMyTools
+ * 3. Add your tools inside the function
+ * 4. Register in src/index.ts:
+ *    - import { registerMyTools } from "./tools/my-tools.js";
+ *    - registerMyTools(server);
+ * 5. Build and test: npm run build && npm run inspector
+ *
+ * ============================================================================
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * Register your custom tools here.
+ * Rename this function to match your file name!
+ */
+export declare function registerTemplateTools(server: McpServer): void;
+//# sourceMappingURL=_template.d.ts.map

package/build/tools/_template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_template.d.ts","sourceRoot":"","sources":["../../src/tools/_template.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGpE;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAoG7D"}

package/build/tools/_template.js

@@ -0,0 +1,124 @@
+/**
+ * ============================================================================
+ * TOOL TEMPLATE - Copy This File to Create Your Own Tools!
+ * ============================================================================
+ *
+ * QUICK START:
+ * 1. Copy this file: cp src/tools/_template.ts src/tools/my-tools.ts
+ * 2. Rename the function: registerTemplateTools → registerMyTools
+ * 3. Add your tools inside the function
+ * 4. Register in src/index.ts:
+ *    - import { registerMyTools } from "./tools/my-tools.js";
+ *    - registerMyTools(server);
+ * 5. Build and test: npm run build && npm run inspector
+ *
+ * ============================================================================
+ */
+import { z } from "zod";
+/**
+ * Register your custom tools here.
+ * Rename this function to match your file name!
+ */
+export function registerTemplateTools(server) {
+    // ---------------------------------------------------------------------------
+    // EXAMPLE: Simple tool with one parameter
+    // ---------------------------------------------------------------------------
+    server.tool("example_tool", // Tool name
+    "An example tool - replace with your own!", // Description
+    {
+        input: z.string().describe("Your input parameter"),
+    }, async ({ input }) => {
+        // Your logic here!
+        const result = `You said: ${input}`;
+        return {
+            content: [{ type: "text", text: result }],
+        };
+    });
+    // ---------------------------------------------------------------------------
+    // EXAMPLE: Tool with multiple parameters
+    // ---------------------------------------------------------------------------
+    server.tool("example_multi_param", "Example with multiple parameters", {
+        required_param: z.string().describe("This is required"),
+        optional_param: z.string().optional().describe("This is optional"),
+        number_param: z.number().describe("A number input"),
+        choice_param: z.enum(["option1", "option2", "option3"]).describe("Pick one"),
+    }, async ({ required_param, optional_param, number_param, choice_param }) => {
+        return {
+            content: [{
+                    type: "text",
+                    text: `Required: ${required_param}, Optional: ${optional_param || "not provided"}, Number: ${number_param}, Choice: ${choice_param}`,
+                }],
+        };
+    });
+    // ---------------------------------------------------------------------------
+    // EXAMPLE: Tool with error handling
+    // ---------------------------------------------------------------------------
+    server.tool("example_with_error", "Example showing error handling", {
+        value: z.number().describe("A positive number"),
+    }, async ({ value }) => {
+        // Validate and handle errors
+        if (value < 0) {
+            return {
+                content: [{ type: "text", text: "Error: Value must be positive!" }],
+                isError: true, // Marks this as an error response
+            };
+        }
+        return {
+            content: [{ type: "text", text: `Success! Value is ${value}` }],
+        };
+    });
+    // ---------------------------------------------------------------------------
+    // EXAMPLE: Async tool (API calls, file operations, etc.)
+    // ---------------------------------------------------------------------------
+    server.tool("example_async", "Example with async operations", {
+        url: z.string().url().describe("A URL to fetch"),
+    }, async ({ url }) => {
+        try {
+            // Example: fetch data from an API
+            // const response = await fetch(url);
+            // const data = await response.json();
+            // Simulated async operation
+            await new Promise(resolve => setTimeout(resolve, 100));
+            return {
+                content: [{ type: "text", text: `Would fetch: ${url}` }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `Error fetching URL: ${error}` }],
+                isError: true,
+            };
+        }
+    });
+}
+// =============================================================================
+// ZOD TYPE REFERENCE
+// =============================================================================
+//
+// BASIC TYPES:
+//   z.string()                    - Text
+//   z.number()                    - Number (int or float)
+//   z.boolean()                   - True/false
+//   z.date()                      - Date object
+//
+// MODIFIERS:
+//   .optional()                   - Not required
+//   .default("value")             - Default value if not provided
+//   .describe("text")             - Description for AI
+//
+// VALIDATIONS:
+//   z.string().min(1)             - Minimum length
+//   z.string().max(100)           - Maximum length
+//   z.string().email()            - Must be email
+//   z.string().url()              - Must be URL
+//   z.number().min(0)             - Minimum value
+//   z.number().max(100)           - Maximum value
+//   z.number().int()              - Must be integer
+//
+// COMPLEX TYPES:
+//   z.enum(["a", "b", "c"])       - One of specific values
+//   z.array(z.string())           - Array of strings
+//   z.object({ key: z.string() }) - Nested object
+//
+// =============================================================================
+//# sourceMappingURL=_template.js.map

package/build/tools/_template.js.map

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

package/build/tools/calculator.d.ts

@@ -0,0 +1,32 @@
+/**
+ * ============================================================================
+ * CALCULATOR TOOLS - Example MCP Tools
+ * ============================================================================
+ *
+ * This file shows how to create MCP tools step by step.
+ * Use this as a template when creating your own tools!
+ *
+ * WHAT IS A TOOL?
+ * A tool is a function that AI can call. When a user asks Claude to
+ * "add 5 and 3", Claude will call your 'add' tool with {a: 5, b: 3}.
+ *
+ * ANATOMY OF A TOOL:
+ *
+ *   server.tool(
+ *     "tool_name",           // Unique name (lowercase, underscores ok)
+ *     "Description",         // What the tool does (AI reads this!)
+ *     { params },            // Input parameters with Zod validation
+ *     async (inputs) => {}   // Your function that does the work
+ *   );
+ *
+ * COPY THIS FILE to create your own tools!
+ * ============================================================================
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * Registers all calculator tools with the MCP server.
+ *
+ * @param server - The MCP server instance to register tools with
+ */
+export declare function registerCalculatorTools(server: McpServer): void;
+//# sourceMappingURL=calculator.d.ts.map

package/build/tools/calculator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"calculator.d.ts","sourceRoot":"","sources":["../../src/tools/calculator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGpE;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAgH/D"}

package/build/tools/calculator.js

@@ -0,0 +1,130 @@
+/**
+ * ============================================================================
+ * CALCULATOR TOOLS - Example MCP Tools
+ * ============================================================================
+ *
+ * This file shows how to create MCP tools step by step.
+ * Use this as a template when creating your own tools!
+ *
+ * WHAT IS A TOOL?
+ * A tool is a function that AI can call. When a user asks Claude to
+ * "add 5 and 3", Claude will call your 'add' tool with {a: 5, b: 3}.
+ *
+ * ANATOMY OF A TOOL:
+ *
+ *   server.tool(
+ *     "tool_name",           // Unique name (lowercase, underscores ok)
+ *     "Description",         // What the tool does (AI reads this!)
+ *     { params },            // Input parameters with Zod validation
+ *     async (inputs) => {}   // Your function that does the work
+ *   );
+ *
+ * COPY THIS FILE to create your own tools!
+ * ============================================================================
+ */
+import { z } from "zod"; // Zod validates that inputs are the correct type
+/**
+ * Registers all calculator tools with the MCP server.
+ *
+ * @param server - The MCP server instance to register tools with
+ */
+export function registerCalculatorTools(server) {
+    // ---------------------------------------------------------------------------
+    // TOOL: add
+    // ---------------------------------------------------------------------------
+    // This is the simplest possible tool - takes two numbers, returns their sum.
+    // ---------------------------------------------------------------------------
+    server.tool(
+    // 1. TOOL NAME - must be unique across all your tools
+    "add", 
+    // 2. DESCRIPTION - AI uses this to decide when to call your tool
+    //    Write it clearly! The better the description, the better AI uses it.
+    "Add two numbers together", 
+    // 3. INPUT SCHEMA - defines what parameters the tool accepts
+    //    Uses Zod for validation: z.number(), z.string(), z.boolean(), etc.
+    //    .describe() helps AI understand what each parameter is for
+    {
+        a: z.number().describe("First number to add"),
+        b: z.number().describe("Second number to add"),
+    }, 
+    // 4. HANDLER FUNCTION - this runs when AI calls your tool
+    //    Receives validated inputs, must return a content array
+    async ({ a, b }) => {
+        // Your tool logic goes here!
+        const result = a + b;
+        // Return format: array of content blocks
+        // Most common: { type: "text", text: "your result" }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `${a} + ${b} = ${result}`,
+                },
+            ],
+        };
+    });
+    // ---------------------------------------------------------------------------
+    // TOOL: subtract
+    // ---------------------------------------------------------------------------
+    server.tool("subtract", "Subtract the second number from the first", {
+        a: z.number().describe("Number to subtract from"),
+        b: z.number().describe("Number to subtract"),
+    }, async ({ a, b }) => {
+        const result = a - b;
+        return {
+            content: [{ type: "text", text: `${a} - ${b} = ${result}` }],
+        };
+    });
+    // ---------------------------------------------------------------------------
+    // TOOL: multiply
+    // ---------------------------------------------------------------------------
+    server.tool("multiply", "Multiply two numbers together", {
+        a: z.number().describe("First number to multiply"),
+        b: z.number().describe("Second number to multiply"),
+    }, async ({ a, b }) => {
+        const result = a * b;
+        return {
+            content: [{ type: "text", text: `${a} × ${b} = ${result}` }],
+        };
+    });
+    // ---------------------------------------------------------------------------
+    // TOOL: divide (with error handling example)
+    // ---------------------------------------------------------------------------
+    // This tool shows how to handle errors gracefully.
+    // Set isError: true to tell AI the operation failed.
+    // ---------------------------------------------------------------------------
+    server.tool("divide", "Divide the first number by the second", {
+        a: z.number().describe("Dividend (number to be divided)"),
+        b: z.number().describe("Divisor (number to divide by)"),
+    }, async ({ a, b }) => {
+        // Always validate inputs and handle edge cases!
+        if (b === 0) {
+            return {
+                content: [
+                    { type: "text", text: "Error: Cannot divide by zero" },
+                ],
+                isError: true, // Tells AI this is an error response
+            };
+        }
+        const result = a / b;
+        return {
+            content: [{ type: "text", text: `${a} ÷ ${b} = ${result}` }],
+        };
+    });
+}
+// =============================================================================
+// QUICK REFERENCE: Zod Types You Can Use
+// =============================================================================
+//
+// z.string()           - Text input
+// z.number()           - Numeric input
+// z.boolean()          - True/false
+// z.enum(["a", "b"])   - One of specific values
+// z.array(z.string())  - Array of strings
+// z.object({...})      - Nested object
+// z.optional()         - Makes parameter optional
+// z.default("value")   - Provides default value
+//
+// Chain them: z.string().optional().describe("Optional text")
+// =============================================================================
+//# sourceMappingURL=calculator.js.map

package/build/tools/calculator.js.map

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

package/build/tools/daily-notes.d.ts

@@ -0,0 +1,19 @@
+/**
+ * ============================================================================
+ * OBSIDIAN MCP - Daily/Periodic Notes Tools
+ * ============================================================================
+ *
+ * Tools for working with daily notes, weekly notes, and other periodic notes.
+ * Requires the Periodic Notes plugin or Daily Notes core plugin in Obsidian.
+ * ============================================================================
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { ObsidianClient } from "../utils/client.js";
+/**
+ * Register daily/periodic notes tools with the MCP server.
+ *
+ * @param server - The MCP server instance
+ * @param client - The Obsidian API client
+ */
+export declare function registerDailyNotesTools(server: McpServer, client: ObsidianClient): void;
+//# sourceMappingURL=daily-notes.d.ts.map

package/build/tools/daily-notes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"daily-notes.d.ts","sourceRoot":"","sources":["../../src/tools/daily-notes.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAIpD;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,cAAc,GACrB,IAAI,CA8iBN"}