Obsidian Local REST API MCP Server

Instructions

Implementation Reference

• src/index.ts:130-139 (handler)

  The core handler function in the ObsidianApiClient class that executes the tool logic by making a POST request to the Obsidian REST API /notes/upsert endpoint with the provided path, content, and frontmatter.

  async createOrUpdateNote(path: string, content: string, frontmatter: Record<string, any> = {}) {
    return this.request("/notes/upsert", {
      method: "POST",
      body: JSON.stringify({
        path,
        content,
        front_matter: frontmatter
      }),
    });
  }

• src/index.ts:330-338 (schema)

  JSON schema defining the input parameters and validation for the create_or_update_note tool: path and content required, frontmatter optional.

  inputSchema: {
    type: "object",
    properties: {
      path: { type: "string", description: "Path for the note (without .md extension)" },
      content: { type: "string", description: "Note content" },
      frontmatter: { type: "object", description: "Frontmatter metadata", default: {} },
    },
    required: ["path", "content"],
  },

• src/index.ts:327-339 (registration)

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

  {
    name: "create_or_update_note",
    description: "Create or update a note with content and frontmatter. Performs upsert operation - creates if doesn't exist, updates if it does.",
    inputSchema: {
      type: "object",
      properties: {
        path: { type: "string", description: "Path for the note (without .md extension)" },
        content: { type: "string", description: "Note content" },
        frontmatter: { type: "object", description: "Frontmatter metadata", default: {} },
      },
      required: ["path", "content"],
    },
  },

• src/index.ts:476-482 (handler)

  Dispatch handler in the MCP server's CallToolRequestSchema that routes the tool call to the client method.

  case "create_or_update_note":
    result = await this.client.createOrUpdateNote(
      args?.path as string,
      args?.content as string,
      args?.frontmatter as Record<string, any>
    );
    break;