show
Navigate to and display areas, projects, tags, todos, or built-in lists like inbox or today in Things 3 task management.
Instructions
导航到并显示区域、项目、标签、待办事项或内置列表。
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | ID或内置列表名(inbox, today, anytime, upcoming, someday, logbook等) | |
| query | No | 查询名称（如果未提供id） | |
| filter | No | 按标签筛选，逗号分隔 |
Implementation Reference
- src/index.js:541-553 (handler)The handler function for the 'show' tool. It constructs a Things URL using buildThingsUrl('show', args) and opens it via openThingsUrl to navigate and display the specified item or list in Things.
async handleShow(args) { const url = buildThingsUrl('show', args); await this.openThingsUrl(url); return { content: [ { type: 'text', text: `✅ 导航命令已发送${args.id ? ` (${args.id})` : args.query ? ` (${args.query})` : ''}`, }, ], }; } - src/index.js:318-338 (registration)Registration of the 'show' tool in the MCP server's tool list, including name, description, and input schema definition.
{ name: 'show', description: '导航到并显示区域、项目、标签、待办事项或内置列表。', inputSchema: { type: 'object', properties: { id: { type: 'string', description: 'ID或内置列表名(inbox, today, anytime, upcoming, someday, logbook等)', }, query: { type: 'string', description: '查询名称（如果未提供id）', }, filter: { type: 'string', description: '按标签筛选，逗号分隔', }, }, }, }, - src/utils.js:84-93 (helper)Helper function used by the 'show' handler to construct the Things URL scheme for the 'show' command.
export function buildThingsUrl(command, params = {}) { const baseUrl = `things:///${command}`; const queryString = buildQueryString(params); if (!queryString) { return baseUrl; } return `${baseUrl}?${queryString}`; }