basecamp-mcp 1.0.1

package/README.md

@@ -0,0 +1,155 @@
+# Basecamp MCP Server
+
+Model Context Protocol (MCP) server for Basecamp integration. Enables LLMs to interact with Basecamp projects, messages, todos, comments, people, and kanban boards.
+
+## Getting Started
+
+The Basecamp MCP server requires Node.js 18+ and works with various MCP clients including Claude Code CLI, Claude Desktop, Cursor, VS Code, and others.
+
+### Standard Configuration
+
+The baseline setup applies across most tools:
+
+```json
+{
+  "mcpServers": {
+    "basecamp": {
+      "command": "npx",
+      "args": ["-y", "@basecamp/mcp@latest"],
+      "env": {
+        "BASECAMP_CLIENT_ID": "your_client_id",
+        "BASECAMP_CLIENT_SECRET": "your_client_secret",
+        "BASECAMP_REFRESH_TOKEN": "your_refresh_token",
+        "BASECAMP_USER_AGENT": "YourApp (your@email.com)",
+        "BASECAMP_ACCOUNT_ID": "account_id"
+      }
+    }
+  }
+}
+```
+
+### Installation by Client
+
+**Claude Code CLI:**
+```bash
+claude mcp add basecamp npx @basecamp/mcp@latest \
+  -e BASECAMP_CLIENT_ID=your_client_id \
+  -e BASECAMP_CLIENT_SECRET=your_client_secret \
+  -e BASECAMP_REFRESH_TOKEN=your_refresh_token \
+  -e BASECAMP_USER_AGENT="YourApp (your@email.com)" \
+  -e BASECAMP_ACCOUNT_ID=account_id
+```
+
+**Claude Desktop:** Follow the MCP install guide using the standard config above.
+
+**Cursor:** One-click installation available, or manually add configuration through Settings → Tools & Integrations → New MCP Server.
+
+**VS Code:** One-click installation provided, or use the CLI:
+```bash
+code --add-mcp '{"name":"basecamp","command":"npx","args":["-y", "@basecamp/mcp@latest"]}'
+```
+
+**Gemini CLI & Windsurf:** Refer to their respective documentation; use the standard config template.
+
+## Configuration
+
+The server requires the following environment variables:
+
+* **`BASECAMP_CLIENT_ID`** — Your Basecamp OAuth client ID
+* **`BASECAMP_CLIENT_SECRET`** — Your Basecamp OAuth client secret
+* **`BASECAMP_REFRESH_TOKEN`** — Your Basecamp refresh token for authentication
+* **`BASECAMP_USER_AGENT`** — Your application identifier (format: YourApp (our@email.com))
+* **`BASECAMP_ACCOUNT_ID`** — Your Basecamp account ID
+
+### Complete Configuration Example
+
+```json
+{
+  "mcpServers": {
+    "basecamp": {
+      "command": "npx",
+      "args": ["-y", "@basecamp/mcp@latest"],
+      "env": {
+        "BASECAMP_CLIENT_ID": "your_client_id",
+        "BASECAMP_CLIENT_SECRET": "your_client_secret",
+        "BASECAMP_REFRESH_TOKEN": "your_refresh_token",
+        "BASECAMP_USER_AGENT": "YourApp (your@email.com)",
+        "BASECAMP_ACCOUNT_ID": "account_id"
+      }
+    }
+  }
+}
+```
+
+## Usage
+
+### Running the Server
+
+```bash
+npm start
+```
+
+Or for development with auto-reload:
+
+```bash
+npm run dev
+```
+
+### Available Tools
+
+#### Projects
+- `basecamp_list_projects` - List all accessible projects with optional filtering
+- `basecamp_get_project` - Get detailed project information including dock configuration
+
+#### Messages
+- `basecamp_list_messages` - List messages in a message board with optional filtering
+- `basecamp_list_message_types` - List available message types/categories for a project
+- `basecamp_get_message` - Get single message details
+- `basecamp_create_message` - Create new message with optional category and draft status
+- `basecamp_update_message` - Update message with advanced content editing (supports full replacement, append, prepend, search/replace)
+
+#### TODOs
+- `basecamp_get_todoset` - Get todo set container with all todo lists
+- `basecamp_list_todos` - List todos in a list with status filtering (active/archived)
+- `basecamp_create_todo` - Create new todo with optional description
+- `basecamp_complete_todo` - Mark todo as complete
+- `basecamp_uncomplete_todo` - Mark todo as incomplete
+
+#### Comments
+- `basecamp_list_comments` - List comments on any resource (works universally on all recording types)
+- `basecamp_create_comment` - Add comment to any resource
+- `basecamp_update_comment` - Update comment with advanced content editing (supports full replacement, append, prepend, search/replace)
+
+#### People
+- `basecamp_get_me` - Get personal information for the authenticated user
+- `basecamp_list_people` - List all people with optional filtering by name, email, or title
+- `basecamp_get_person` - Get person details
+
+#### Kanban
+- `basecamp_list_kanban_columns` - List all columns in a kanban board
+- `basecamp_list_kanban_cards` - List cards in a column with steps and assignees
+- `basecamp_get_kanban_card` - Get complete details of a specific card
+- `basecamp_create_kanban_card` - Create new card with title and optional content
+- `basecamp_update_kanban_card` - Update card with advanced content editing (supports full replacement, append, prepend, search/replace, plus title, due date, assignees, notifications)
+- `basecamp_move_kanban_card` - Move a card to a different column and/or position
+- `basecamp_create_kanban_step` - Add checklist step to a card
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Run type checking
+npx tsc --noEmit
+
+# Build
+npm run build
+
+# Clean build artifacts
+npm run clean
+```
+
+## License
+
+MIT

package/dist/constants.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Shared constants for the Basecamp MCP server
+ */
+/** Maximum response size in characters to prevent overwhelming LLM context */
+export declare const CHARACTER_LIMIT = 25000;
+/** Default number of items to return in paginated responses */
+export declare const DEFAULT_LIMIT = 20;
+/** Maximum number of items allowed in a single request */
+export declare const MAX_LIMIT = 100;
+/** Basecamp API base URL pattern */
+export declare const BASECAMP_API_BASE = "https://3.basecampapi.com";
+/** Basecamp web URL pattern for parsing */
+export declare const BASECAMP_WEB_BASE = "https://3.basecamp.com";
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,8EAA8E;AAC9E,eAAO,MAAM,eAAe,QAAQ,CAAC;AAErC,+DAA+D;AAC/D,eAAO,MAAM,aAAa,KAAK,CAAC;AAEhC,0DAA0D;AAC1D,eAAO,MAAM,SAAS,MAAM,CAAC;AAE7B,oCAAoC;AACpC,eAAO,MAAM,iBAAiB,8BAA8B,CAAC;AAE7D,2CAA2C;AAC3C,eAAO,MAAM,iBAAiB,2BAA2B,CAAC"}

package/dist/constants.js

@@ -0,0 +1,14 @@
+/**
+ * Shared constants for the Basecamp MCP server
+ */
+/** Maximum response size in characters to prevent overwhelming LLM context */
+export const CHARACTER_LIMIT = 25000;
+/** Default number of items to return in paginated responses */
+export const DEFAULT_LIMIT = 20;
+/** Maximum number of items allowed in a single request */
+export const MAX_LIMIT = 100;
+/** Basecamp API base URL pattern */
+export const BASECAMP_API_BASE = "https://3.basecampapi.com";
+/** Basecamp web URL pattern for parsing */
+export const BASECAMP_WEB_BASE = "https://3.basecamp.com";
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,8EAA8E;AAC9E,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,CAAC;AAErC,+DAA+D;AAC/D,MAAM,CAAC,MAAM,aAAa,GAAG,EAAE,CAAC;AAEhC,0DAA0D;AAC1D,MAAM,CAAC,MAAM,SAAS,GAAG,GAAG,CAAC;AAE7B,oCAAoC;AACpC,MAAM,CAAC,MAAM,iBAAiB,GAAG,2BAA2B,CAAC;AAE7D,2CAA2C;AAC3C,MAAM,CAAC,MAAM,iBAAiB,GAAG,wBAAwB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+#!/usr/bin/env node
+/**
+ * Basecamp MCP Server
+ *
+ * MCP server for interacting with Basecamp API, providing tools for:
+ * - Projects (discovering bucket IDs)
+ * - Messages (with patch support for updates)
+ * - TODOs (sets, lists, todos)
+ * - Comments (universal - work on any resource)
+ * - People
+ * - Kanban (cards, columns, steps)
+ *
+ * Environment variables required:
+ * - BASECAMP_CLIENT_ID
+ * - BASECAMP_CLIENT_SECRET
+ * - BASECAMP_REFRESH_TOKEN
+ * - BASECAMP_USER_AGENT
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;GAgBG"}

package/dist/index.js

@@ -0,0 +1,71 @@
+#!/usr/bin/env node
+/**
+ * Basecamp MCP Server
+ *
+ * MCP server for interacting with Basecamp API, providing tools for:
+ * - Projects (discovering bucket IDs)
+ * - Messages (with patch support for updates)
+ * - TODOs (sets, lists, todos)
+ * - Comments (universal - work on any resource)
+ * - People
+ * - Kanban (cards, columns, steps)
+ *
+ * Environment variables required:
+ * - BASECAMP_CLIENT_ID
+ * - BASECAMP_CLIENT_SECRET
+ * - BASECAMP_REFRESH_TOKEN
+ * - BASECAMP_USER_AGENT
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { registerCommentTools } from "./tools/comments.js";
+import { registerKanbanTools } from "./tools/kanban.js";
+import { registerMessageTools } from "./tools/messages.js";
+import { registerPeopleTools } from "./tools/people.js";
+// Import tool registration functions
+import { registerProjectTools } from "./tools/projects.js";
+import { registerTodoTools } from "./tools/todos.js";
+/**
+ * Main server initialization and startup
+ */
+async function main() {
+    // Validate required environment variables
+    const requiredEnvVars = [
+        "BASECAMP_CLIENT_ID",
+        "BASECAMP_CLIENT_SECRET",
+        "BASECAMP_REFRESH_TOKEN",
+        "BASECAMP_USER_AGENT",
+    ];
+    const missing = requiredEnvVars.filter((varName) => !process.env[varName]);
+    if (missing.length > 0) {
+        console.error(`ERROR: Missing required environment variables: ${missing.join(", ")}`);
+        console.error("Please set these in your environment or .env file before starting the server.");
+        process.exit(1);
+    }
+    // Create MCP server instance
+    const server = new McpServer({
+        name: "basecamp-mcp-server",
+        version: "1.0.0",
+    });
+    // Register all tool categories
+    console.error("Registering tools...");
+    registerProjectTools(server);
+    registerMessageTools(server);
+    registerTodoTools(server);
+    registerCommentTools(server);
+    registerPeopleTools(server);
+    registerKanbanTools(server);
+    console.error("Tools registered successfully");
+    // Create stdio transport
+    const transport = new StdioServerTransport();
+    // Connect server to transport
+    await server.connect(transport);
+    console.error("Basecamp MCP server running on stdio");
+    console.error("Waiting for client connection...");
+}
+// Run the server
+main().catch((error) => {
+    console.error("Fatal error starting Basecamp MCP server:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,qCAAqC;AACrC,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAErD;;GAEG;AACH,KAAK,UAAU,IAAI;IACjB,0CAA0C;IAC1C,MAAM,eAAe,GAAG;QACtB,oBAAoB;QACpB,wBAAwB;QACxB,wBAAwB;QACxB,qBAAqB;KACtB,CAAC;IAEF,MAAM,OAAO,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;IAC3E,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,CAAC,KAAK,CACX,kDAAkD,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACvE,CAAC;QACF,OAAO,CAAC,KAAK,CACX,+EAA+E,CAChF,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,6BAA6B;IAC7B,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,qBAAqB;QAC3B,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IAEH,+BAA+B;IAC/B,OAAO,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;IACtC,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC7B,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC7B,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC1B,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC7B,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAC5B,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAC5B,OAAO,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC;IAE/C,yBAAyB;IACzB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAE7C,8BAA8B;IAC9B,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,OAAO,CAAC,KAAK,CAAC,sCAAsC,CAAC,CAAC;IACtD,OAAO,CAAC,KAAK,CAAC,kCAAkC,CAAC,CAAC;AACpD,CAAC;AAED,iBAAiB;AACjB,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,2CAA2C,EAAE,KAAK,CAAC,CAAC;IAClE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/schemas/common.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Common Zod schemas used across multiple tools
+ */
+import { z } from "zod";
+/**
+ * Basecamp ID parameter schema
+ */
+export declare const BasecampIdSchema: z.ZodNumber;
+/**
+ * Basecamp URL schema
+ */
+export declare const BasecampUrlSchema: z.ZodString;
+//# sourceMappingURL=common.d.ts.map

package/dist/schemas/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../src/schemas/common.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,eAAO,MAAM,gBAAgB,aAEc,CAAC;AAE5C;;GAEG;AACH,eAAO,MAAM,iBAAiB,aAM3B,CAAC"}

package/dist/schemas/common.js

@@ -0,0 +1,19 @@
+/**
+ * Common Zod schemas used across multiple tools
+ */
+import { z } from "zod";
+/**
+ * Basecamp ID parameter schema
+ */
+export const BasecampIdSchema = z
+    .number()
+    .describe("Basecamp resource identifier");
+/**
+ * Basecamp URL schema
+ */
+export const BasecampUrlSchema = z
+    .string()
+    .url()
+    .startsWith("https://3.basecamp.com/", "Must be a valid Basecamp URL")
+    .describe("Basecamp resource URL (e.g., https://3.basecamp.com/{accountId}/buckets/{bucketId}/messages/{id})");
+//# sourceMappingURL=common.js.map

package/dist/schemas/common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../../src/schemas/common.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC;KAC9B,MAAM,EAAE;KACR,QAAQ,CAAC,8BAA8B,CAAC,CAAC;AAE5C;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC;KAC/B,MAAM,EAAE;KACR,GAAG,EAAE;KACL,UAAU,CAAC,yBAAyB,EAAE,8BAA8B,CAAC;KACrE,QAAQ,CACP,mGAAmG,CACpG,CAAC"}

package/dist/tools/comments.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Comment tools for Basecamp MCP server
+ * Comments work on ANY recording (messages, todos, cards, etc.)
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerCommentTools(server: McpServer): void;
+//# sourceMappingURL=comments.d.ts.map

package/dist/tools/comments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comments.d.ts","sourceRoot":"","sources":["../../src/tools/comments.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAczE,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA0M5D"}

package/dist/tools/comments.js

@@ -0,0 +1,179 @@
+/**
+ * Comment tools for Basecamp MCP server
+ * Comments work on ANY recording (messages, todos, cards, etc.)
+ */
+import { asyncPagedToArray } from "basecamp-client";
+import { z } from "zod";
+import { BasecampIdSchema } from "../schemas/common.js";
+import { initializeBasecampClient } from "../utils/auth.js";
+import { applyContentOperations, ContentOperationFields, htmlRules, validateContentOperations, } from "../utils/contentOperations.js";
+import { handleBasecampError } from "../utils/errorHandlers.js";
+import { serializePerson } from "../utils/serializers.js";
+export function registerCommentTools(server) {
+    server.registerTool("basecamp_list_comments", {
+        title: "List Basecamp Comments",
+        description: "List comments on any Basecamp resource (message, todo, card, etc.). Works universally on all recording types.",
+        inputSchema: {
+            bucket_id: BasecampIdSchema,
+            recording_id: BasecampIdSchema.describe("ID of the resource (message, todo, card, etc.)"),
+        },
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+    }, async (params) => {
+        try {
+            const client = await initializeBasecampClient();
+            const comments = await asyncPagedToArray({
+                fetchPage: client.comments.list,
+                request: {
+                    params: {
+                        bucketId: params.bucket_id,
+                        recordingId: params.recording_id,
+                    },
+                    query: {},
+                },
+            });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(comments.map((c) => ({
+                            id: c.id,
+                            creator: serializePerson(c.creator),
+                            content: c.content,
+                            created_at: c.created_at,
+                        })), null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: handleBasecampError(error) }],
+            };
+        }
+    });
+    server.registerTool("basecamp_create_comment", {
+        title: "Create Basecamp Comment",
+        description: "Add a comment to any Basecamp resource (message, todo, card, etc.).",
+        inputSchema: {
+            bucket_id: BasecampIdSchema,
+            recording_id: BasecampIdSchema,
+            content: z
+                .string()
+                .min(1)
+                .describe(`HTML comment content. To mention people: <bc-attachment sgid="{ person.attachable_sgid }"></bc-attachment>`),
+        },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: true,
+        },
+    }, async (params) => {
+        try {
+            const client = await initializeBasecampClient();
+            const response = await client.comments.create({
+                params: {
+                    bucketId: params.bucket_id,
+                    recordingId: params.recording_id,
+                },
+                body: { content: params.content },
+            });
+            if (response.status !== 201 || !response.body) {
+                throw new Error("Failed to create comment");
+            }
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Comment posted!\n\nID: ${response.body.id}`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: handleBasecampError(error) }],
+            };
+        }
+    });
+    server.registerTool("basecamp_update_comment", {
+        title: "Update Basecamp Comment",
+        description: `Update a comment. Use partial content operations when possible to save on token usage. ${htmlRules}`,
+        inputSchema: {
+            bucket_id: BasecampIdSchema,
+            comment_id: BasecampIdSchema,
+            ...ContentOperationFields,
+        },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: true,
+        },
+    }, async (params) => {
+        try {
+            // Validate at least one operation is provided
+            validateContentOperations(params);
+            const client = await initializeBasecampClient();
+            let finalContent;
+            // Check if we need to fetch current content for partial operations
+            const hasPartialOps = params.content_append ||
+                params.content_prepend ||
+                params.search_replace;
+            if (hasPartialOps || params.content !== undefined) {
+                // Fetch current comment if needed for partial operations
+                if (hasPartialOps) {
+                    const currentResponse = await client.comments.get({
+                        params: {
+                            bucketId: params.bucket_id,
+                            commentId: params.comment_id,
+                        },
+                    });
+                    if (currentResponse.status !== 200 || !currentResponse.body) {
+                        throw new Error(`Failed to fetch current comment: ${currentResponse.status}`);
+                    }
+                    const currentContent = currentResponse.body.content || "";
+                    finalContent = applyContentOperations(currentContent, params);
+                }
+                else {
+                    // Full content replacement
+                    finalContent = params.content;
+                }
+            }
+            // If no content changes (shouldn't happen due to validation, but be safe)
+            if (finalContent === undefined) {
+                throw new Error("No content operations resulted in changes");
+            }
+            // Update the comment
+            const response = await client.comments.update({
+                params: {
+                    bucketId: params.bucket_id,
+                    commentId: params.comment_id,
+                },
+                body: { content: finalContent },
+            });
+            if (response.status !== 200 || !response.body) {
+                throw new Error("Failed to update comment");
+            }
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Comment updated successfully!\n\nID: ${response.body.id}`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: handleBasecampError(error) }],
+            };
+        }
+    });
+}
+//# sourceMappingURL=comments.js.map

package/dist/tools/comments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"comments.js","sourceRoot":"","sources":["../../src/tools/comments.ts"],"names":[],"mappings":"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"}

package/dist/tools/kanban.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Kanban tools for Basecamp MCP server (cards, columns, steps)
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerKanbanTools(server: McpServer): void;
+//# sourceMappingURL=kanban.d.ts.map

package/dist/tools/kanban.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kanban.d.ts","sourceRoot":"","sources":["../../src/tools/kanban.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAczE,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA2b3D"}