get_todoset
Retrieve a project's to-do set from Basecamp, including optional lists, to manage tasks and track progress.
Instructions
Resolves the project's to-do set by reading the dock; can include lists.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| include_lists | No | ||
| project_id | Yes |
Implementation Reference
- src/tools/todosets.ts:32-58 (handler)Handler function that executes the 'get_todoset' tool: resolves todoset from dock, returns info or with lists if requested.async ({ project_id, include_lists }) => { const resolved = await getTodosetFromDock(project_id); if (!resolved) { return { content: [ { type: "text", text: "No to-do set found in the project's dock." }, ], }; } if (!include_lists) { return { content: [{ type: "text", text: JSON.stringify(resolved, null, 2) }], }; } const lists = await bcRequest<any[]>( "GET", `/buckets/${project_id}/todosets/${resolved.id}/todolists.json` ); return { content: [ { type: "text", text: JSON.stringify({ todoset: resolved, lists }, null, 2), }, ], }; }
- src/tools/todosets.ts:27-30 (schema)Input schema using Zod for validating project_id (required number) and optional include_lists (boolean).inputSchema: { project_id: z.number().int(), include_lists: z.boolean().optional(), },
- src/tools/todosets.ts:21-59 (registration)Registration of the 'get_todoset' tool using server.registerTool, including title, description, inputSchema, and handler.server.registerTool( "get_todoset", { title: "Get a project's to-do set (via dock)", description: "Resolves the project's to-do set by reading the dock; can include lists.", inputSchema: { project_id: z.number().int(), include_lists: z.boolean().optional(), }, }, async ({ project_id, include_lists }) => { const resolved = await getTodosetFromDock(project_id); if (!resolved) { return { content: [ { type: "text", text: "No to-do set found in the project's dock." }, ], }; } if (!include_lists) { return { content: [{ type: "text", text: JSON.stringify(resolved, null, 2) }], }; } const lists = await bcRequest<any[]>( "GET", `/buckets/${project_id}/todosets/${resolved.id}/todolists.json` ); return { content: [ { type: "text", text: JSON.stringify({ todoset: resolved, lists }, null, 2), }, ], }; } );
- src/tools/todosets.ts:6-17 (helper)Helper function getTodosetFromDock that fetches project dock and extracts todoset ID and URL, used by the tool handler.async function getTodosetFromDock( project_id: number ): Promise<{ id: number; url: string } | null> { const project = await bcRequest<any>("GET", `/projects/${project_id}.json`); const dock = Array.isArray(project?.dock) ? project.dock : []; const todoset = dock.find((d: any) => (d?.name || d?.app_name) === "todoset"); if (!todoset) return null; const href: string = todoset.url || todoset.href || todoset.api_url || todoset.app_url || ""; const m = href.match(/\/todosets\/(\d+)/); return m ? { id: Number(m[1]), url: href } : null; }