add_note
Attach notes to requests in TaskFlow MCP to include project details, user preferences, or guidelines. Notes are displayed in the task progress table for easy reference during task execution.
Instructions
Add a note to a request. Notes can contain important information about the project, such as user preferences or guidelines.
Notes are displayed in the task progress table and can be referenced when working on tasks.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| content | Yes | ||
| requestId | Yes | ||
| title | Yes |
Input Schema (JSON Schema)
{
"properties": {
"content": {
"type": "string"
},
"requestId": {
"type": "string"
},
"title": {
"type": "string"
}
},
"required": [
"requestId",
"title",
"content"
],
"type": "object"
}
Implementation Reference
- src/tools/TaskFlowTools.ts:625-628 (handler)MCP tool handler function for 'add_note' that parses arguments and calls the service method.async add_note(args: any) { const { requestId, title, content } = args ?? {}; return service.addNote(String(requestId), String(title), String(content)); },
- JSON input schema defining parameters for the add_note tool (requestId, title, content).add_note: { type: "object", properties: { requestId: { type: "string" }, title: { type: "string" }, content: { type: "string" }, }, required: ["requestId", "title", "content"], },
- src/server/TaskFlowServer.ts:76-80 (registration)ADD_NOTE_TOOL is registered in the list of tools provided by the MCP server in response to ListTools requests.DELETE_SUBTASK_TOOL, EXPORT_TASK_STATUS_TOOL, ADD_NOTE_TOOL, UPDATE_NOTE_TOOL, DELETE_NOTE_TOOL,
- Core service implementation that adds a new note to a request, generates ID, sanitizes inputs, persists to file, and returns confirmation.public async addNote(requestId: string, title: string, content: string) { await this.loadTasks(); const req = this.getRequest(requestId); if (!req) return { status: "error", message: "Request not found" }; const now = new Date().toISOString(); const factory = new TaskFactory({ value: this.globalIdCounter }); const noteId = factory.createNoteId(); this.globalIdCounter = factory["counterRef"].value; const note: Note = { id: noteId, title: sanitizeString(title), content: sanitizeString(content), createdAt: now, updatedAt: now, }; if (!req.notes) req.notes = []; req.notes.push(note); await this.saveTasks(); return { status: "note_added", message: `Note "${title}" has been added to request ${requestId}.`, note, }; }