@aniketbiswas/obsidian-mcp-server 1.0.0

package/build/tools/metadata.js

@@ -0,0 +1,447 @@
+/**
+ * ============================================================================
+ * OBSIDIAN MCP - Metadata Tools
+ * ============================================================================
+ *
+ * Tools for managing note metadata: frontmatter, tags, aliases, and properties.
+ * ============================================================================
+ */
+import { z } from "zod";
+import { ObsidianApiError } from "../types/obsidian.js";
+import { parseFrontmatter, stringifyFrontmatter, updateFrontmatter, addTags, removeTags, getAllTags, addAliases, } from "../utils/frontmatter.js";
+/**
+ * Register metadata tools with the MCP server.
+ *
+ * @param server - The MCP server instance
+ * @param client - The Obsidian API client
+ */
+export function registerMetadataTools(server, client) {
+    // ---------------------------------------------------------------------------
+    // TOOL: get_frontmatter
+    // ---------------------------------------------------------------------------
+    // Read frontmatter from a note.
+    // ---------------------------------------------------------------------------
+    server.tool("get_frontmatter", "Get the frontmatter (YAML metadata) from a note. " +
+        "Returns all frontmatter fields including tags, aliases, and custom properties.", {
+        path: z.string().describe("Path to the note."),
+    }, async ({ path }) => {
+        try {
+            const filePath = path.endsWith(".md") ? path : `${path}.md`;
+            const note = await client.getNote(filePath);
+            if (!note.frontmatter || Object.keys(note.frontmatter).length === 0) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify({
+                                success: true,
+                                path: filePath,
+                                hasFrontmatter: false,
+                                frontmatter: {},
+                            }, null, 2),
+                        },
+                    ],
+                };
+            }
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            success: true,
+                            path: filePath,
+                            hasFrontmatter: true,
+                            frontmatter: note.frontmatter,
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const message = error instanceof ObsidianApiError ? error.message : String(error);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error getting frontmatter: ${message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    // ---------------------------------------------------------------------------
+    // TOOL: update_frontmatter
+    // ---------------------------------------------------------------------------
+    // Update frontmatter fields in a note.
+    // ---------------------------------------------------------------------------
+    server.tool("update_frontmatter", "Update frontmatter fields in a note. " +
+        "Can add new fields or update existing ones. " +
+        "Existing fields not specified are preserved.", {
+        path: z.string().describe("Path to the note."),
+        properties: z
+            .object({
+            title: z.string().optional(),
+            tags: z.array(z.string()).optional(),
+            aliases: z.array(z.string()).optional(),
+            created: z.string().optional(),
+            modified: z.string().optional(),
+            publish: z.boolean().optional(),
+        })
+            .passthrough()
+            .describe("Frontmatter properties to set or update."),
+    }, async ({ path, properties }) => {
+        try {
+            const filePath = path.endsWith(".md") ? path : `${path}.md`;
+            // Get current content
+            const content = await client.getFile(filePath);
+            // Update frontmatter
+            const updatedContent = updateFrontmatter(content, properties);
+            // Write back
+            await client.putFile(filePath, updatedContent);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            success: true,
+                            message: `Frontmatter updated for: ${filePath}`,
+                            path: filePath,
+                            updatedProperties: Object.keys(properties),
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const message = error instanceof ObsidianApiError ? error.message : String(error);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error updating frontmatter: ${message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    // ---------------------------------------------------------------------------
+    // TOOL: set_frontmatter_property
+    // ---------------------------------------------------------------------------
+    // Set a single frontmatter property.
+    // ---------------------------------------------------------------------------
+    server.tool("set_frontmatter_property", "Set a single frontmatter property in a note. " +
+        "Creates the property if it doesn't exist.", {
+        path: z.string().describe("Path to the note."),
+        key: z.string().describe("Property name to set."),
+        value: z
+            .union([
+            z.string(),
+            z.number(),
+            z.boolean(),
+            z.array(z.string()),
+            z.null(),
+        ])
+            .describe("Value to set (string, number, boolean, string array, or null to remove)."),
+    }, async ({ path, key, value }) => {
+        try {
+            const filePath = path.endsWith(".md") ? path : `${path}.md`;
+            // Get current content
+            const content = await client.getFile(filePath);
+            const { frontmatter, body } = parseFrontmatter(content);
+            // Update property
+            if (value === null) {
+                delete frontmatter[key];
+            }
+            else {
+                frontmatter[key] = value;
+            }
+            // Rebuild content
+            const newContent = stringifyFrontmatter(frontmatter) + body;
+            await client.putFile(filePath, newContent);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            success: true,
+                            message: value === null
+                                ? `Property "${key}" removed from: ${filePath}`
+                                : `Property "${key}" set in: ${filePath}`,
+                            path: filePath,
+                            property: key,
+                            value: value,
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const message = error instanceof ObsidianApiError ? error.message : String(error);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error setting property: ${message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    // ---------------------------------------------------------------------------
+    // TOOL: get_tags
+    // ---------------------------------------------------------------------------
+    // Get all tags from a note (frontmatter + inline).
+    // ---------------------------------------------------------------------------
+    server.tool("get_tags", "Get all tags from a note. " +
+        "Includes tags from frontmatter and inline tags (#tag) in the content.", {
+        path: z.string().describe("Path to the note."),
+    }, async ({ path }) => {
+        try {
+            const filePath = path.endsWith(".md") ? path : `${path}.md`;
+            const content = await client.getFile(filePath);
+            const tags = getAllTags(content);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            success: true,
+                            path: filePath,
+                            tagCount: tags.length,
+                            tags,
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const message = error instanceof ObsidianApiError ? error.message : String(error);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error getting tags: ${message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    // ---------------------------------------------------------------------------
+    // TOOL: add_tags
+    // ---------------------------------------------------------------------------
+    // Add tags to a note's frontmatter.
+    // ---------------------------------------------------------------------------
+    server.tool("add_tags", "Add tags to a note's frontmatter. " +
+        "Tags are added without duplicates. Creates frontmatter if needed.", {
+        path: z.string().describe("Path to the note."),
+        tags: z
+            .array(z.string())
+            .min(1)
+            .describe("Tags to add (with or without # prefix)."),
+    }, async ({ path, tags }) => {
+        try {
+            const filePath = path.endsWith(".md") ? path : `${path}.md`;
+            // Get current content
+            const content = await client.getFile(filePath);
+            // Add tags
+            const updatedContent = addTags(content, tags);
+            // Write back
+            await client.putFile(filePath, updatedContent);
+            // Get final tags
+            const finalTags = getAllTags(updatedContent);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            success: true,
+                            message: `Tags added to: ${filePath}`,
+                            path: filePath,
+                            addedTags: tags,
+                            allTags: finalTags,
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const message = error instanceof ObsidianApiError ? error.message : String(error);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error adding tags: ${message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    // ---------------------------------------------------------------------------
+    // TOOL: remove_tags
+    // ---------------------------------------------------------------------------
+    // Remove tags from a note's frontmatter.
+    // ---------------------------------------------------------------------------
+    server.tool("remove_tags", "Remove tags from a note's frontmatter. " +
+        "Only removes tags from frontmatter, not inline tags.", {
+        path: z.string().describe("Path to the note."),
+        tags: z
+            .array(z.string())
+            .min(1)
+            .describe("Tags to remove (with or without # prefix)."),
+    }, async ({ path, tags }) => {
+        try {
+            const filePath = path.endsWith(".md") ? path : `${path}.md`;
+            // Get current content
+            const content = await client.getFile(filePath);
+            // Remove tags
+            const updatedContent = removeTags(content, tags);
+            // Write back
+            await client.putFile(filePath, updatedContent);
+            // Get final tags
+            const finalTags = getAllTags(updatedContent);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            success: true,
+                            message: `Tags removed from: ${filePath}`,
+                            path: filePath,
+                            removedTags: tags,
+                            remainingTags: finalTags,
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const message = error instanceof ObsidianApiError ? error.message : String(error);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error removing tags: ${message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    // ---------------------------------------------------------------------------
+    // TOOL: add_aliases
+    // ---------------------------------------------------------------------------
+    // Add aliases to a note's frontmatter.
+    // ---------------------------------------------------------------------------
+    server.tool("add_aliases", "Add aliases (alternative names) to a note's frontmatter. " +
+        "Aliases help find notes by different names.", {
+        path: z.string().describe("Path to the note."),
+        aliases: z.array(z.string()).min(1).describe("Aliases to add."),
+    }, async ({ path, aliases }) => {
+        try {
+            const filePath = path.endsWith(".md") ? path : `${path}.md`;
+            // Get current content
+            const content = await client.getFile(filePath);
+            // Add aliases
+            const updatedContent = addAliases(content, aliases);
+            // Write back
+            await client.putFile(filePath, updatedContent);
+            // Get updated frontmatter
+            const { frontmatter } = parseFrontmatter(updatedContent);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            success: true,
+                            message: `Aliases added to: ${filePath}`,
+                            path: filePath,
+                            addedAliases: aliases,
+                            allAliases: frontmatter.aliases || [],
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const message = error instanceof ObsidianApiError ? error.message : String(error);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error adding aliases: ${message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    // ---------------------------------------------------------------------------
+    // TOOL: get_all_tags_in_vault
+    // ---------------------------------------------------------------------------
+    // Get all unique tags used across the vault.
+    // ---------------------------------------------------------------------------
+    server.tool("get_all_tags_in_vault", "Get a list of all unique tags used across the entire vault. " +
+        "Useful for understanding tag taxonomy and finding related notes.", {
+        folder: z
+            .string()
+            .optional()
+            .describe("Optional folder to limit the search."),
+    }, async ({ folder }) => {
+        try {
+            // Get all markdown files
+            const allFiles = await client.listAllFiles(folder || "", 10);
+            const mdFiles = allFiles.filter((f) => f.type === "file" && f.extension === "md");
+            // Collect all tags
+            const tagCounts = {};
+            for (const file of mdFiles.slice(0, 500)) {
+                // Limit to avoid timeout
+                try {
+                    const content = await client.getFile(file.path);
+                    const tags = getAllTags(content);
+                    for (const tag of tags) {
+                        tagCounts[tag] = (tagCounts[tag] || 0) + 1;
+                    }
+                }
+                catch {
+                    // Skip files that can't be read
+                }
+            }
+            // Sort by count
+            const sortedTags = Object.entries(tagCounts)
+                .sort((a, b) => b[1] - a[1])
+                .map(([tag, count]) => ({ tag, count }));
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            success: true,
+                            folder: folder || "/",
+                            filesScanned: Math.min(mdFiles.length, 500),
+                            uniqueTags: sortedTags.length,
+                            tags: sortedTags,
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const message = error instanceof ObsidianApiError ? error.message : String(error);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error getting vault tags: ${message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=metadata.js.map

package/build/tools/metadata.js.map

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

package/build/tools/navigation.d.ts

@@ -0,0 +1,19 @@
+/**
+ * ============================================================================
+ * OBSIDIAN MCP - Navigation Tools
+ * ============================================================================
+ *
+ * Tools for navigating the Obsidian UI: opening notes, getting active file,
+ * and executing Obsidian commands.
+ * ============================================================================
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { ObsidianClient } from "../utils/client.js";
+/**
+ * Register navigation tools with the MCP server.
+ *
+ * @param server - The MCP server instance
+ * @param client - The Obsidian API client
+ */
+export declare function registerNavigationTools(server: McpServer, client: ObsidianClient): void;
+//# sourceMappingURL=navigation.d.ts.map

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

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