save_note
Create new notes in GetNote MCP Server, supporting plain text, links, and images. Upload images first for image notes, and track link processing progress.
Instructions
新建笔记(⚠️ 仅支持新建,不支持编辑已有笔记)。支持纯文本笔记(plain_text)、链接笔记(link)和图片笔记(img_text)。
图片笔记流程:先用 upload_image 上传图片获取 image_url,再调用此接口传入 image_urls。
返回值说明:
纯文本/图片笔记:返回
id、title、created_at、updated_at。链接笔记(link):额外返回
tasks数组(每项含task_id和url)。链接笔记由 AI 异步处理,可用get_note_task_progress工具传入task_id查询处理进度。
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| title | No | 笔记标题 | |
| content | No | 笔记正文(Markdown 格式)。链接笔记不需要此字段 | |
| note_type | No | 笔记类型:plain_text(纯文本,默认)、link(链接笔记)、img_text(图片笔记) | plain_text |
| tags | No | 标签列表(最多 5 个,每个不超过 10 个汉字) | |
| parent_id | No | 父笔记 ID(创建子笔记时填,父笔记的 is_child_note 必须为 false) | |
| link_url | No | 链接 URL(note_type=link 时必填) | |
| image_urls | No | 图片 URL 列表(note_type=img_text 时必填) |
Implementation Reference
- src/index.ts:566-579 (handler)The tool handler logic for 'save_note', mapping input parameters to the request body and calling the client's 'saveNote' method.
case "save_note": { const body: SaveNoteReq = {}; if (input.title !== undefined) body.title = input.title as string; if (input.content !== undefined) body.content = input.content as string; if (input.note_type !== undefined) body.note_type = input.note_type as SaveNoteReq["note_type"]; if (input.tags !== undefined) body.tags = input.tags as string[]; if (input.parent_id !== undefined) body.parent_id = input.parent_id as number | string; if (input.link_url !== undefined) body.link_url = input.link_url as string; if (input.image_urls !== undefined) body.image_urls = input.image_urls as string[]; return client.saveNote(body); } - src/client.ts:106-108 (handler)The implementation of 'saveNote' in the client class, which performs the actual API request.
async saveNote(body: SaveNoteReq) { return this.request<SaveNoteResp>("POST", "/resource/note/save", undefined, body); }