Basecamp MCP Server

Instructions

Implementation Reference

• src/tools/kanban.ts:677-711 (handler)

  Handler function that executes the logic to move a kanban card to a new column and optional position using the Basecamp API client.

  async (params) => {
    try {
      const client = await initializeBasecampClient();
      const response = await client.cardTableCards.move({
        params: { bucketId: params.bucket_id, cardId: params.card_id },
        body: {
          column_id: params.column_id,
          ...(params.position !== undefined
            ? { position: params.position }
            : {}),
        },
      });
  
      if (response.status !== 204) {
        throw new Error("Failed to move card");
      }
  
      return {
        content: [
          {
            type: "text",
            text: `Card moved successfully to column ${params.column_id}${
              params.position !== undefined
                ? ` at position ${params.position}`
                : ""
            }!`,
          },
        ],
      };
    } catch (error) {
      return {
        content: [{ type: "text", text: handleBasecampError(error) }],
      };
    }
  },

• src/tools/kanban.ts:653-676 (schema)

  Input schema and metadata (title, description, annotations) for the basecamp_move_kanban_card tool.

  {
    title: "Move Kanban Card",
    description:
      "Move a kanban card to a different column and/or position within that column.",
    inputSchema: {
      bucket_id: BasecampIdSchema,
      card_id: BasecampIdSchema,
      column_id: BasecampIdSchema,
      position: z
        .number()
        .int()
        .nonnegative()
        .optional()
        .describe(
          "Position within the destination column (zero-indexed). If not specified, card will be added to the end of the column.",
        ),
    },
    annotations: {
      readOnlyHint: false,
      destructiveHint: false,
      idempotentHint: false,
      openWorldHint: true,
    },
  },

• src/tools/kanban.ts:651-712 (registration)

  Registration of the basecamp_move_kanban_card tool in the registerKanbanTools function, including name, schema, and handler.

  server.registerTool(
    "basecamp_move_kanban_card",
    {
      title: "Move Kanban Card",
      description:
        "Move a kanban card to a different column and/or position within that column.",
      inputSchema: {
        bucket_id: BasecampIdSchema,
        card_id: BasecampIdSchema,
        column_id: BasecampIdSchema,
        position: z
          .number()
          .int()
          .nonnegative()
          .optional()
          .describe(
            "Position within the destination column (zero-indexed). If not specified, card will be added to the end of the column.",
          ),
      },
      annotations: {
        readOnlyHint: false,
        destructiveHint: false,
        idempotentHint: false,
        openWorldHint: true,
      },
    },
    async (params) => {
      try {
        const client = await initializeBasecampClient();
        const response = await client.cardTableCards.move({
          params: { bucketId: params.bucket_id, cardId: params.card_id },
          body: {
            column_id: params.column_id,
            ...(params.position !== undefined
              ? { position: params.position }
              : {}),
          },
        });
  
        if (response.status !== 204) {
          throw new Error("Failed to move card");
        }
  
        return {
          content: [
            {
              type: "text",
              text: `Card moved successfully to column ${params.column_id}${
                params.position !== undefined
                  ? ` at position ${params.position}`
                  : ""
              }!`,
            },
          ],
        };
      } catch (error) {
        return {
          content: [{ type: "text", text: handleBasecampError(error) }],
        };
      }
    },
  );