joplin/packages/lib/services/mcp/tools/createNote.ts

import Note from '../../../models/Note';
import Folder from '../../../models/Folder';
import { McpTool, ToolError } from '../types';

interface Input {
	title?: string;
	body?: string;
	notebook_id?: string;
	is_todo?: boolean;
}

const tool: McpTool = {
	id: 'create_note',
	description: 'Create a new note. Returns the created note id. If notebook_id is omitted, the note is created in the default notebook.',
	inputSchema: {
		type: 'object',
		properties: {
			title: { type: 'string', description: 'Note title.' },
			body: { type: 'string', description: 'Note body in Markdown.' },
			notebook_id: { type: 'string', description: 'Optional notebook (folder) id. Use list_notebooks to find ids.' },
			is_todo: { type: 'boolean', description: 'Set to true to create the note as a to-do.' },
		},
		required: ['title'],
	},
	handler: async (input: Input) => {
		if (typeof input.title !== 'string' || !input.title.trim()) {
			throw new ToolError('Missing or invalid "title" parameter');
		}
		// `is_todo: 'false'` is otherwise truthy and would silently flip the flag.
		if (input.is_todo !== undefined && typeof input.is_todo !== 'boolean') {
			throw new ToolError('"is_todo" must be a boolean');
		}

		let parentId = input.notebook_id;
		if (parentId) {
			const folder = await Folder.load(parentId);
			if (!folder) throw new ToolError(`Notebook not found: ${parentId}`);
		} else {
			const defaultFolder = await Folder.defaultFolder();
			if (!defaultFolder) throw new ToolError('No notebook available. Create one first or pass notebook_id.');
			parentId = defaultFolder.id;
		}

		const saved = await Note.save({
			title: input.title,
			body: input.body ?? '',
			parent_id: parentId,
			is_todo: input.is_todo ? 1 : 0,
		});

		return { id: saved.id, title: saved.title, notebook_id: saved.parent_id };
	},
};

export default tool;