Obsidian Tools MCP Server

Instructions

Implementation Reference

• src/index.ts:435-451 (handler)

  The handler function that executes the create_note tool: resolves the full path, checks for existence and overwrite flag, ensures directory exists, writes the file content, and returns success message.

  async function handleCreateNote(args: {
    path: string;
    content: string;
    overwrite?: boolean;
  }): Promise<string> {
    const fullPath = resolvePath(args.path);
  
    if (!args.overwrite && (await fileExists(fullPath))) {
      throw new Error(
        `Note already exists at ${args.path}. Use overwrite: true to replace.`
      );
    }
  
    await ensureDir(fullPath);
    await fs.writeFile(fullPath, args.content, "utf-8");
    return `Successfully created note at ${args.path}`;
  }

• src/index.ts:29-48 (schema)

  Input schema defining parameters for create_note: path (string, required), content (string, required), overwrite (boolean, optional default false).

  inputSchema: {
    type: "object",
    properties: {
      path: {
        type: "string",
        description:
          "Path for the new note relative to vault root (e.g., 'folder/note.md')",
      },
      content: {
        type: "string",
        description: "Content of the note in Markdown format",
      },
      overwrite: {
        type: "boolean",
        description: "If true, overwrite existing note. Default: false",
        default: false,
      },
    },
    required: ["path", "content"],
  },

• src/index.ts:25-49 (registration)

  Tool registration in the tools array, including name, description, and input schema, used for ListTools response.

  {
    name: "create_note",
    description:
      "Create a new note in the Obsidian vault. Supports nested folder creation.",
    inputSchema: {
      type: "object",
      properties: {
        path: {
          type: "string",
          description:
            "Path for the new note relative to vault root (e.g., 'folder/note.md')",
        },
        content: {
          type: "string",
          description: "Content of the note in Markdown format",
        },
        overwrite: {
          type: "boolean",
          description: "If true, overwrite existing note. Default: false",
          default: false,
        },
      },
      required: ["path", "content"],
    },
  },

• src/index.ts:865-869 (registration)

  Dispatch case in the CallToolRequestSchema handler that routes 'create_note' calls to the handleCreateNote function.

  case "create_note":
    result = await handleCreateNote(
      args as { path: string; content: string; overwrite?: boolean }
    );
    break;