basecamp_create_message
Create and post messages to Basecamp message boards to communicate updates, share information, and collaborate with team members on projects.
Instructions
Create a new message in a Basecamp message board.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| bucket_id | Yes | Basecamp resource identifier | |
| content | No | Message content (HTML supported) | |
| message_board_id | Yes | ||
| status | No | Message status | active |
| subject | Yes | Message subject/title |
Implementation Reference
- src/tools/messages.ts:239-272 (handler)The handler function for basecamp_create_message tool. Initializes the Basecamp client and calls client.messages.create with the provided parameters, returning success message with ID, subject, and URL or error.async (params) => { try { const client = await initializeBasecampClient(); const response = await client.messages.create({ params: { bucketId: params.bucket_id, messageBoardId: params.message_board_id, }, body: { subject: params.subject, content: params.content, category_id: params.message_type_id, status: params.status, }, }); if (response.status !== 201 || !response.body) { throw new Error(`Failed to create message`); } return { content: [ { type: "text", text: `Message created successfully!\n\nID: ${response.body.id}\nSubject: ${response.body.title}\nURL: ${response.body.app_url}`, }, ], }; } catch (error) { return { content: [{ type: "text", text: handleBasecampError(error) }], }; } },
- src/tools/messages.ts:214-231 (schema)Zod input schema for the basecamp_create_message tool defining required bucket_id, message_board_id, subject, and optional content, message_type_id, status.inputSchema: { bucket_id: BasecampIdSchema, message_board_id: BasecampIdSchema, subject: z.string().min(1).max(500).describe("Message subject/title"), content: z .string() .optional() .describe( `HTML message content. To mention people: <bc-attachment sgid="{ person.attachable_sgid }"></bc-attachment>`, ), message_type_id: BasecampIdSchema.optional().describe( "Optional message type/category ID", ), status: z .enum(["active", "draft"]) .default("active") .describe("Message status"), },
- src/tools/messages.ts:208-273 (registration)Complete registration of the basecamp_create_message tool within registerMessageTools function, including schema, metadata, and handler.// basecamp_create_message server.registerTool( "basecamp_create_message", { title: "Create Basecamp Message", description: `Create a new message in a Basecamp message board.`, inputSchema: { bucket_id: BasecampIdSchema, message_board_id: BasecampIdSchema, subject: z.string().min(1).max(500).describe("Message subject/title"), content: z .string() .optional() .describe( `HTML message content. To mention people: <bc-attachment sgid="{ person.attachable_sgid }"></bc-attachment>`, ), message_type_id: BasecampIdSchema.optional().describe( "Optional message type/category ID", ), status: z .enum(["active", "draft"]) .default("active") .describe("Message status"), }, annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true, }, }, async (params) => { try { const client = await initializeBasecampClient(); const response = await client.messages.create({ params: { bucketId: params.bucket_id, messageBoardId: params.message_board_id, }, body: { subject: params.subject, content: params.content, category_id: params.message_type_id, status: params.status, }, }); if (response.status !== 201 || !response.body) { throw new Error(`Failed to create message`); } return { content: [ { type: "text", text: `Message created successfully!\n\nID: ${response.body.id}\nSubject: ${response.body.title}\nURL: ${response.body.app_url}`, }, ], }; } catch (error) { return { content: [{ type: "text", text: handleBasecampError(error) }], }; } }, );
- src/index.ts:62-62 (registration)Top-level call to registerMessageTools(server) in main server setup, which registers the basecamp_create_message among other message tools.registerMessageTools(server);