create_note_from_template

Create Obsidian notes using templates with variable replacement to standardize formatting and content structure.

Instructions

テンプレートを使用してObsidianノートを作成します

Input Schema

TableJSON Schema

Name	Required	Description
`templateName`	Yes	TEMPLATEフォルダ内のテンプレート名（.md拡張子なし）
`variables`	Yes	テンプレート内の変数を置換するためのオブジェクト
`outputPath`	Yes	ノートの保存先パス（vault相対パス）
`overwrite`	No	既存ファイルを上書きするかどうか

Implementation Reference

src/obsidian-handler.ts:26-54 (handler)

Primary handler function executing the tool: validates output path, processes template with variables using TemplateEngine, builds full path, ensures directory exists, checks for overwrite if specified, writes content to file, returns success message.

async createNoteFromTemplate(options: CreateNoteOptions): Promise<string> {
  // パスの検証
  if (!FileUtils.validatePath(this.config.vaultPath, options.outputPath)) {
    throw new Error('無効なファイルパスです');
  }

  // テンプレートを処理
  const content = await this.templateEngine.processTemplate(
    options.templateName,
    options.variables
  );

  // 出力パスを構築
  const fullOutputPath = path.join(this.config.vaultPath, options.outputPath);
  const outputDir = path.dirname(fullOutputPath);

  // ディレクトリを作成
  await FileUtils.ensureDir(outputDir);

  // ファイルの存在チェック
  if (!options.overwrite && await FileUtils.fileExists(fullOutputPath)) {
    throw new Error(`ファイル '${options.outputPath}' は既に存在します`);
  }

  // ファイルを書き込み
  await fs.writeFile(fullOutputPath, content, 'utf-8');

  return `ノート '${options.outputPath}' を作成しました`;
}

src/server.ts:54-79 (registration)

Tool registration definition in the ListTools handler, specifying name, description, and detailed input schema for parameters.

  name: 'create_note_from_template',
  description: 'テンプレートを使用してObsidianノートを作成します',
  inputSchema: {
    type: 'object',
    properties: {
      templateName: {
        type: 'string',
        description: 'TEMPLATEフォルダ内のテンプレート名（.md拡張子なし）',
      },
      variables: {
        type: 'object',
        description: 'テンプレート内の変数を置換するためのオブジェクト',
      },
      outputPath: {
        type: 'string',
        description: 'ノートの保存先パス（vault相対パス）',
      },
      overwrite: {
        type: 'boolean',
        description: '既存ファイルを上書きするかどうか',
        default: false,
      },
    },
    required: ['templateName', 'variables', 'outputPath'],
  },
},

src/types.ts:15-20 (schema)
TypeScript interface defining the input parameters for the createNoteFromTemplate handler, matching the tool's inputSchema.
```
export interface CreateNoteOptions {
  templateName: string;
  variables: Record<string, any>;
  outputPath: string;
  overwrite?: boolean;
}
```

src/server.ts:259-269 (handler)

Dispatch handler in the MCP server that maps tool call arguments to the ObsidianHandler method and returns the result as MCP content.

case 'create_note_from_template':
  const result = await this.obsidianHandler.createNoteFromTemplate({
    templateName: args.templateName as string,
    variables: (args.variables as Record<string, any>) || {},
    outputPath: args.outputPath as string,
    overwrite: (args.overwrite as boolean) || false,
  });
  return {
    content: [{ type: 'text', text: result }],
  };

Obsidian MCP Server