Basecamp MCP Server

Instructions

Implementation Reference

• src/lib/basecamp-client.ts:92-103 (handler)

  Core implementation that fetches todo lists from Basecamp API: gets project, finds todoset, queries API.

  async getTodoLists(projectId: string): Promise<TodoList[]> {
    // First get the project to find the todoset
    const project = await this.getProject(projectId);
    const todoset = project.dock.find(item => item.name === 'todoset');
    
    if (!todoset) {
      throw new Error(`No todoset found for project ${projectId}`);
    }
  
    const response = await this.client.get(`/buckets/${projectId}/todosets/${todoset.id}/todolists.json`);
    return response.data;
  }

• src/index.ts:579-591 (handler)

  MCP CallToolRequest handler case: invokes BasecampClient.getTodoLists and returns formatted JSON response.

  case 'get_todolists': {
    const todolists = await client.getTodoLists(typedArgs.project_id);
    return {
      content: [{
        type: 'text',
        text: JSON.stringify({
          status: 'success',
          todolists,
          count: todolists.length
        }, null, 2)
      }]
    };
  }

• src/index.ts:153-162 (registration)

  Tool registration in ListToolsRequestHandler: defines name, description, and input schema (requires project_id).

    name: 'get_todolists',
    description: 'Get todo lists for a project',
    inputSchema: {
      type: 'object',
      properties: {
        project_id: { type: 'string', description: 'The project ID' },
      },
      required: ['project_id'],
    },
  },

• src/index.ts:155-162 (schema)

  Input schema definition for the get_todolists tool.

    inputSchema: {
      type: 'object',
      properties: {
        project_id: { type: 'string', description: 'The project ID' },
      },
      required: ['project_id'],
    },
  },