Basecamp MCP Server

Instructions

Implementation Reference

• src/tools/todos.ts:261-276 (handler)

  The core handler function that implements the basecamp_uncomplete_todo tool logic. It uses the Basecamp client to uncomplete the specified todo.

  async (params) => {
    try {
      const client = await initializeBasecampClient();
      await client.todos.uncomplete({
        params: { bucketId: params.bucket_id, todoId: params.todo_id },
      });
  
      return {
        content: [{ type: "text", text: "Todo marked as incomplete!" }],
      };
    } catch (error) {
      return {
        content: [{ type: "text", text: handleBasecampError(error) }],
      };
    }
  },

• src/tools/todos.ts:250-253 (schema)

  Input schema defining the required parameters: bucket_id and todo_id, both using the shared BasecampIdSchema.

  inputSchema: {
    bucket_id: BasecampIdSchema,
    todo_id: BasecampIdSchema,
  },

• src/tools/todos.ts:245-277 (registration)

  Registers the basecamp_uncomplete_todo tool with the MCP server inside the registerTodoTools function.

  server.registerTool(
    "basecamp_uncomplete_todo",
    {
      title: "Uncomplete Basecamp Todo",
      description: "Mark a todo as incomplete (undo completion).",
      inputSchema: {
        bucket_id: BasecampIdSchema,
        todo_id: BasecampIdSchema,
      },
      annotations: {
        readOnlyHint: false,
        destructiveHint: false,
        idempotentHint: true,
        openWorldHint: true,
      },
    },
    async (params) => {
      try {
        const client = await initializeBasecampClient();
        await client.todos.uncomplete({
          params: { bucketId: params.bucket_id, todoId: params.todo_id },
        });
  
        return {
          content: [{ type: "text", text: "Todo marked as incomplete!" }],
        };
      } catch (error) {
        return {
          content: [{ type: "text", text: handleBasecampError(error) }],
        };
      }
    },
  );

• src/index.ts:63-63 (registration)

  Top-level call to register all todo tools, including basecamp_uncomplete_todo, in the main server setup.

  registerTodoTools(server);

• src/schemas/common.ts:10-12 (schema)

  Shared schema for Basecamp IDs used in the tool's inputSchema.

  export const BasecampIdSchema = z
    .number()
    .describe("Basecamp resource identifier");