basecamp_create_message

Create messages in Basecamp message boards to share updates, announcements, or discussions within projects. Specify subject, content, and board location for organized team communication.

Instructions

Create a new message in a Basecamp message board.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`bucket_id`	Yes	Basecamp resource identifier
`message_board_id`	Yes
`subject`	Yes	Message subject/title
`content`	No	HTML message content. To mention people: <bc-attachment sgid="{ person.attachable_sgid }"></bc-attachment>
`message_type_id`	No	Optional message type/category ID
`status`	No	Message status	active

Implementation Reference

src/tools/messages.ts:239-272 (handler)

The asynchronous handler function that executes the basecamp_create_message tool. It initializes the Basecamp client, calls the create method on messages with the provided parameters, handles the response, and returns success or error content.

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)

Input schema for the basecamp_create_message tool, defining parameters like bucket_id, message_board_id, subject, content, message_type_id, and status using Zod validation.

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)

Registration of the basecamp_create_message tool in the registerMessageTools function using server.registerTool, specifying the tool name, input schema, annotations, and handler function.

// 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) }],
      };
    }
  },
);

Basecamp MCP Server