Basecamp MCP Server

Instructions

Implementation Reference

• src/index.ts:621-633 (handler)

  MCP tool handler for 'get_columns' that invokes the Basecamp client method and formats the response as MCP content.

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

• src/index.ts:189-199 (schema)

  Input schema definition for the 'get_columns' tool, specifying required project_id and card_table_id parameters.

    name: 'get_columns',
    description: 'Get all columns in a card table',
    inputSchema: {
      type: 'object',
      properties: {
        project_id: { type: 'string', description: 'The project ID' },
        card_table_id: { type: 'string', description: 'The card table ID' },
      },
      required: ['project_id', 'card_table_id'],
    },
  },

• src/lib/basecamp-client.ts:144-147 (helper)

  Core implementation of getColumns in BasecampClient, fetching card table details and extracting the lists (columns).

  async getColumns(projectId: string, cardTableId: string): Promise<Column[]> {
    const cardTableDetails = await this.getCardTableDetails(projectId, cardTableId);
    return cardTableDetails.lists || [];
  }

• src/lib/basecamp-client.ts:131-141 (helper)

  Supporting method getCardTableDetails used by getColumns to fetch card table data via API.

  async getCardTableDetails(projectId: string, cardTableId: string): Promise<CardTable> {
    try {
      const response = await this.client.get(`/buckets/${projectId}/card_tables/${cardTableId}.json`);
      return response.data;
    } catch (error: any) {
      if (error.response?.status === 204) {
        return { id: cardTableId, title: 'Card Table', lists: [], status: 'empty' };
      }
      throw error;
    }
  }