Obsidian Local REST API MCP Server

Instructions

Implementation Reference

• src/index.ts:163-168 (handler)

  The handler function in ObsidianApiClient class that implements find_related_notes by making an HTTP request to the Obsidian API endpoint for related notes based on tags or links.

  async findRelatedNotes(path: string, on: string[] = ["tags", "links"]) {
    const params = new URLSearchParams({
      on: on.join(","),
    });
    return this.request(`/vault/notes/related/${encodeURIComponent(path)}?${params}`);
  }

• src/index.ts:383-395 (schema)

  Input schema definition for the find_related_notes tool, specifying parameters path (required) and on (optional array of 'tags' or 'links').

  inputSchema: {
    type: "object",
    properties: {
      path: { type: "string", description: "Path to the source note" },
      on: {
        type: "array",
        items: { type: "string", enum: ["tags", "links"] },
        description: "Relationship criteria to use for finding related notes",
        default: ["tags", "links"]
      },
    },
    required: ["path"],
  },

• src/index.ts:500-505 (registration)

  Tool registration in the MCP CallToolRequestSchema handler switch statement, dispatching calls to the client handler.

  case "find_related_notes":
    result = await this.client.findRelatedNotes(
      args?.path as string,
      args?.on as string[]
    );
    break;

• src/index.ts:380-396 (registration)

  Tool definition and registration in the ListTools response, including name, description, and schema.

  {
    name: "find_related_notes",
    description: "Find notes related to a given note based on shared tags, links, or backlinks",
    inputSchema: {
      type: "object",
      properties: {
        path: { type: "string", description: "Path to the source note" },
        on: {
          type: "array",
          items: { type: "string", enum: ["tags", "links"] },
          description: "Relationship criteria to use for finding related notes",
          default: ["tags", "links"]
        },
      },
      required: ["path"],
    },
  },