list_todolists
Retrieve and display all to-do lists from a specified Basecamp project to organize and track tasks efficiently.
Instructions
Resolves the project's to-do set from dock, then lists its to-do lists.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| project_id | Yes |
Implementation Reference
- src/tools/todosets.ts:70-91 (handler)Handler function implementing the 'list_todolists' tool logic: resolves todoset from dock and lists todolists.async ({ project_id }) => { const resolved = await getTodosetFromDock(project_id); if (!resolved) { return { content: [ { type: "text", text: "No to-do set found in the project's dock." }, ], }; } const lists = await bcRequest<any[]>( "GET", `/buckets/${project_id}/todosets/${resolved.id}/todolists.json` ); const text = Array.isArray(lists) && lists.length ? lists.map((t: any) => `${t.id}: ${t.name}`).join("\n") : "No to-do lists found."; return { content: [{ type: "text", text: `To-do set ${resolved.id}\n${text}` }], }; } );
- src/tools/todosets.ts:64-69 (schema)Schema definition including title, description, and input schema for 'list_todolists' tool.{ title: "List to-do lists for a project", description: "Resolves the project's to-do set from dock, then lists its to-do lists.", inputSchema: { project_id: z.number().int() }, },
- src/tools/todosets.ts:62-91 (registration)Local registration of the 'list_todolists' tool using server.registerTool.server.registerTool( "list_todolists", { title: "List to-do lists for a project", description: "Resolves the project's to-do set from dock, then lists its to-do lists.", inputSchema: { project_id: z.number().int() }, }, async ({ project_id }) => { const resolved = await getTodosetFromDock(project_id); if (!resolved) { return { content: [ { type: "text", text: "No to-do set found in the project's dock." }, ], }; } const lists = await bcRequest<any[]>( "GET", `/buckets/${project_id}/todosets/${resolved.id}/todolists.json` ); const text = Array.isArray(lists) && lists.length ? lists.map((t: any) => `${t.id}: ${t.name}`).join("\n") : "No to-do lists found."; return { content: [{ type: "text", text: `To-do set ${resolved.id}\n${text}` }], }; } );
- src/tools/todosets.ts:6-17 (helper)Helper function getTodosetFromDock to resolve todoset ID from project dock, used by list_todolists.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; }
- src/basecamp-mcp.ts:5-13 (registration)Top-level import and invocation of registerTodosetTools(server), which registers list_todolists among others.import { registerTodosetTools } from "./tools/todosets.js"; import { registerTodoTools } from "./tools/todos.js"; import { registerMessageTools } from "./tools/messages.js"; const server = new McpServer({ name: "basecamp", version: "0.3.0" }); // Register tools registerProjectsTools(server); registerTodosetTools(server);