add_project
Create new projects in Things 3 with title, notes, deadlines, tags, areas, and subtasks to organize tasks effectively.
Instructions
创建新的项目。支持标题、备注、区域、标签、子任务等。
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "add_project"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| title | No | 项目标题 | |
| notes | No | 备注内容 | |
| when | No | 时间安排: today, tomorrow, evening, anytime, someday, 日期或日期时间 | |
| deadline | No | 截止日期(yyyy-mm-dd) | |
| tags | No | 标签,逗号分隔 | |
| areaId | No | 区域ID | |
| area | No | 区域标题 | |
| todos | No | 子待办事项列表 | |
| completed | No | 是否标记为完成 | |
| canceled | No | 是否标记为取消 | |
| reveal | No | 是否导航进入项目 |
Implementation Reference
- src/index.js:487-499 (handler)The handler function that implements the core logic of the 'add_project' tool. It builds a Things URL scheme using the provided arguments and opens it to trigger project creation in the Things app.
async handleAddProject(args) { const url = buildThingsUrl('add-project', args); await this.openThingsUrl(url); return { content: [ { type: 'text', text: `✅ 项目创建命令已发送${args.title ? `: ${args.title}` : ''}`, }, ], }; } - src/index.js:120-169 (schema)Input schema defining the parameters accepted by the 'add_project' tool, including title, notes, scheduling, tags, area, subtasks, and flags.
inputSchema: { type: 'object', properties: { title: { type: 'string', description: '项目标题', }, notes: { type: 'string', description: '备注内容', }, when: { type: 'string', description: '时间安排: today, tomorrow, evening, anytime, someday, 日期或日期时间', }, deadline: { type: 'string', description: '截止日期(yyyy-mm-dd)', }, tags: { type: 'string', description: '标签,逗号分隔', }, areaId: { type: 'string', description: '区域ID', }, area: { type: 'string', description: '区域标题', }, todos: { type: 'array', items: { type: 'string' }, description: '子待办事项列表', }, completed: { type: 'boolean', description: '是否标记为完成', }, canceled: { type: 'boolean', description: '是否标记为取消', }, reveal: { type: 'boolean', description: '是否导航进入项目', }, }, }, - src/index.js:117-170 (registration)Registers the 'add_project' tool in the ListToolsRequestSchema handler, providing name, description, and input schema.
{ name: 'add_project', description: '创建新的项目。支持标题、备注、区域、标签、子任务等。', inputSchema: { type: 'object', properties: { title: { type: 'string', description: '项目标题', }, notes: { type: 'string', description: '备注内容', }, when: { type: 'string', description: '时间安排: today, tomorrow, evening, anytime, someday, 日期或日期时间', }, deadline: { type: 'string', description: '截止日期(yyyy-mm-dd)', }, tags: { type: 'string', description: '标签,逗号分隔', }, areaId: { type: 'string', description: '区域ID', }, area: { type: 'string', description: '区域标题', }, todos: { type: 'array', items: { type: 'string' }, description: '子待办事项列表', }, completed: { type: 'boolean', description: '是否标记为完成', }, canceled: { type: 'boolean', description: '是否标记为取消', }, reveal: { type: 'boolean', description: '是否导航进入项目', }, }, }, }, - src/index.js:429-430 (registration)Dispatches 'add_project' tool calls to the handleAddProject method in the CallToolRequestSchema handler.
case 'add_project': return await this.handleAddProject(args); - src/utils.js:84-93 (helper)Helper function used by the handler to construct the Things URL scheme for the 'add-project' command, including parameter mapping and encoding.
export function buildThingsUrl(command, params = {}) { const baseUrl = `things:///${command}`; const queryString = buildQueryString(params); if (!queryString) { return baseUrl; } return `${baseUrl}?${queryString}`; }