Basecamp

Learn how to use Basecamp with Composio

Overview

SLUG: BASECAMP

Description

Project management and team collaboration tool by 37signals

Authentication Details

client_id
stringRequired
client_secret
stringRequired
oauth_redirect_uri
stringDefaults to https://backend.composio.dev/api/v1/auth-apps/add
scopes
string
subdomain
stringRequired
user_agent
stringRequired

Connecting to Basecamp

Create an auth config

Use the dashboard to create an auth config for the Basecamp toolkit. This allows you to connect multiple Basecamp accounts to Composio for agents to use.

1

Select App

Navigate to Basecamp.

2

Configure Auth Config Settings

Select among the supported auth schemes of and configure them here.

3

Create and Get auth config ID

Click “Create Basecamp Auth Config”. After creation, copy the displayed ID starting with ac_. This is your auth config ID. This is not a sensitive ID — you can save it in environment variables or a database. This ID will be used to create connections to the toolkit for a given user.

Connect Your Account

Using OAuth2

1from composio import Composio
2
3# Replace these with your actual values
4basecamp_auth_config_id = "ac_YOUR_BASECAMP_CONFIG_ID" # Auth config ID created above
5user_id = "0000-0000-0000" # UUID from database/application
6
7composio = Composio()
8
9
10def authenticate_toolkit(user_id: str, auth_config_id: str):
11 connection_request = composio.connected_accounts.initiate(
12 user_id=user_id,
13 auth_config_id=auth_config_id,
14 )
15
16 print(
17 f"Visit this URL to authenticate Basecamp: {connection_request.redirect_url}"
18 )
19
20 # This will wait for the auth flow to be completed
21 connection_request.wait_for_connection(timeout=15)
22 return connection_request.id
23
24
25connection_id = authenticate_toolkit(user_id, basecamp_auth_config_id)
26
27# You can also verify the connection status using:
28connected_account = composio.connected_accounts.get(connection_id)
29print(f"Connected account: {connected_account}")

Tools

Executing tools

To prototype you can execute some tools to see the responses and working on the Basecamp toolkit’s playground

For code examples, see the Tool calling guide and Provider examples.

Tool List

Tool Name: Add On-Hold Section to Column

Description

Tool to add an on-hold section to a card table column. Use when organizing cards that are temporarily paused or waiting.

Action Parameters

bucket_id
integerRequired
column_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Change Step Completion

Description

Tool to mark a card step as completed or uncompleted in Basecamp. Use when you need to toggle the completion status of a step on a card table.

Action Parameters

bucket_id
integerRequired
completion
stringRequired
step_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Complete To-Do

Description

Tool to mark a to-do as completed in Basecamp. Use when you need to complete a to-do item.

Action Parameters

bucket_id
integerRequired
todo_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create Card in Column

Description

Tool to create a new card in a column of a Basecamp card table. Use when you need to add a card to a card table column with optional content and due date.

Action Parameters

bucket_id
integerRequired
column_id
integerRequired
content
string
due_on
string
notify
boolean
title
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create Step in Card

Description

Tool to create a step within a card in a Basecamp card table. Use when you need to add a subtask or checklist item to an existing card with optional due date and assignees.

Action Parameters

assignees
string
bucket_id
integerRequired
card_id
integerRequired
due_on
string
title
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create Chatbot

Description

Tool to create a new chatbot in a Basecamp Campfire chat. Use when you need to add an automated bot to a chat room for posting messages and responding to commands.

Action Parameters

bucket_id
integerRequired
chat_id
integerRequired
command_url
string
service_name
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create Chatbot Line

Description

Tool to post a message as a chatbot to a Basecamp Campfire. Use when you need to post messages via a chatbot integration without OAuth authentication.

Action Parameters

bucket_id
integerRequired
chat_id
integerRequired
chatbot_key
stringRequired
content
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create Document in Vault

Description

Tool to create a new document in a Basecamp vault. Use when you need to publish a document in a specific project vault with title, HTML content, and optional publication status.

Action Parameters

bucket_id
integerRequired
content
stringRequired
status
string
title
stringRequired
vault_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create Message in Message Board

Description

Tool to create a new message in a Basecamp message board within a project. Use when you need to publish a message with optional rich HTML content and custom subscriptions.

Action Parameters

bucket_id
integerRequired
category_id
integer
content
string
message_board_id
integerRequired
status
stringRequired
subject
stringRequired
subscriptions
array

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create Message Type

Description

Tool to create a new message type (category) in a Basecamp project. Use when you need to create a custom message category for organizing different types of messages.

Action Parameters

bucket_id
integerRequired
icon
stringRequired
name
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create Project from Template

Description

Tool to create a new project from a Basecamp template asynchronously. Use when you need to instantiate a project based on an existing template. Poll the returned URL to monitor construction progress until status becomes 'completed'.

Action Parameters

project
objectRequired
template_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create Schedule Entry

Description

Tool to create a new schedule entry (event/meeting) in a Basecamp schedule. Use when you need to add an event with start/end times and optional participants.

Action Parameters

all_day
boolean
bucket_id
integerRequired
description
string
ends_at
stringRequired
notify
boolean
participant_ids
array
schedule_id
integerRequired
starts_at
stringRequired
summary
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create To-Do

Description

Tool to create a new to-do in a Basecamp to-do list. Use when you need to add a task with optional description, assignees, and due date.

Action Parameters

assignee_ids
array
bucket_id
integerRequired
completion_subscriber_ids
array
content
stringRequired
description
string
due_on
string
notify
boolean
starts_on
string
todolist_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create To-Do List Group

Description

Tool to create a new to-do group within a parent to-do list in Basecamp. Use when organizing todos into groups with optional color coding.

Action Parameters

bucket_id
integerRequired
color
string
name
stringRequired
todolist_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create Upload in Vault

Description

Tool to create a new upload (file) in a Basecamp vault. Use when you need to create an upload entry for a previously uploaded attachment in a specific project vault.

Action Parameters

attachable_sgid
stringRequired
base_name
string
bucket_id
integerRequired
description
string
vault_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create a Vault

Description

Tool to create a new vault (folder) within an existing parent vault in a Basecamp project. Use when you need to organize documents and files hierarchically by creating nested vaults.

Action Parameters

bucket_id
integerRequired
title
stringRequired
vault_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Delete Card Table Column On-Hold Section

Description

Tool to remove the on-hold section from a card table column. Use when you need to delete the on-hold section from a column in a Basecamp project's card table.

Action Parameters

bucket_id
integerRequired
column_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Unsubscribe from Card Table Column

Description

Tool to unsubscribe from a card table column. Use when you want to stop watching a specific column and no longer receive notifications about changes to it.

Action Parameters

bucket_id
integerRequired
list_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Delete Message Category

Description

Tool to delete a message type (category) from a Basecamp project. Use when removing a custom message category from a project. Permanently deletes the specified message type.

Action Parameters

bucket_id
integerRequired
category_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Delete Campfire Chatbot Integration

Description

Tool to delete a chatbot integration from a Campfire chat. Use when removing a chatbot from the entire account. Requires admin permissions.

Action Parameters

bucket_id
integerRequired
chat_id
integerRequired
integration_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Delete Campfire Line

Description

Tool to delete a Campfire line from a chat conversation. Use when removing a specific message from a Basecamp Campfire.

Action Parameters

bucket_id
integerRequired
chat_id
integerRequired
line_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Unpin Recording

Description

Tool to unpin a recording (message) in a Basecamp project. Use when you need to remove the pinned status from a message on a message board or project.

Action Parameters

bucket_id
integerRequired
recording_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Unsubscribe from Recording

Description

Tool to unsubscribe from a recording. Use when you want to stop watching a specific recording and no longer receive notifications about changes to it. Returns success even if the user wasn't previously subscribed.

Action Parameters

bucket_id
integerRequired
recording_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Uncomplete To-Do

Description

Tool to uncomplete a to-do item in Basecamp. Use when you need to mark a completed to-do as pending again.

Action Parameters

bucket_id
integerRequired
todo_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Delete Campfire Line

Description

Tool to delete a Campfire line from a chat conversation. Use when removing a specific message from a Basecamp Campfire chat.

Action Parameters

bucket_id
integerRequired
chat_id
integerRequired
line_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Delete Chatbot

Description

Tool to delete a chatbot from a Campfire chat. Use when removing a chatbot from the account. Note: Deletion is account-wide and only account administrators can delete chatbots.

Action Parameters

bucket_id
integerRequired
chat_id
integerRequired
chatbot_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Delete Message Type

Description

Tool to delete a message type from a Basecamp project. Use when removing a custom message category. Permanently removes the specified message type.

Action Parameters

bucket_id
integerRequired
category_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Delete Project

Description

Tool to trash a Basecamp project by ID. Use when you need to move a project to trash. Trashed projects are soft-deleted and will be permanently removed after 30 days.

Action Parameters

project_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Delete Template

Description

Tool to mark a template as trashed in Basecamp. Use when deleting a template; it will be permanently removed after 30 days.

Action Parameters

template_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Delete Webhook

Description

Tool to delete a webhook from a Basecamp project. Use when you need to remove a webhook subscription from a project. Permanently deletes the specified webhook.

Action Parameters

bucket_id
integerRequired
webhook_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get card table from project

Description

Tool to retrieve a specific card table with all its columns from a Basecamp project. Use when you need information about a card table including its title, columns, and subscribers.

Action Parameters

bucket_id
integerRequired
card_table_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get card from card table

Description

Tool to retrieve a specific card from a card table within a project. Use when you need detailed information about a card including its title, status, assignees, and steps.

Action Parameters

bucket_id
integerRequired
card_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Card Table Column

Description

Tool to retrieve a specific column from a card table within a Basecamp project. Use when you need to fetch details about a specific card table column by its ID.

Action Parameters

bucket_id
integerRequired
column_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Cards from Card Table List

Description

Tool to retrieve a paginated list of cards from a card table column. Use when you need to fetch cards from a specific list/column within a Basecamp project's card table.

Action Parameters

bucket_id
integerRequired
list_id
integerRequired
page
integer

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Message Categories

Description

Tool to retrieve all message types (categories) from a Basecamp project. Use when you need to list all available message categories for organizing messages in a project.

Action Parameters

bucket_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Message Category by ID

Description

Tool to retrieve a specific message type/category by ID from a Basecamp project. Use when you need details about a specific message category.

Action Parameters

bucket_id
integerRequired
category_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Campfire Chat

Description

Tool to retrieve a specific Campfire chat from a Basecamp project. Use when you need to get details about a particular chat, including its title, creator, topic, and message URLs.

Action Parameters

bucket_id
integerRequired
chat_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Campfire Chatbot Integrations

Description

Tool to retrieve all chatbot integrations from a Campfire chat. Use when you need to get the list of chatbots accessible to the account with chat-specific line URLs for posting messages.

Action Parameters

bucket_id
integerRequired
chat_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Chatbot Integration by ID

Description

Tool to retrieve a specific chatbot integration from a Basecamp Campfire chat. Use when you need to get details about a chatbot, including its service name, command URL, and lines URL for posting as the bot.

Action Parameters

bucket_id
integerRequired
chat_id
integerRequired
integration_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Campfire Lines

Description

Tool to retrieve a paginated list of Campfire lines from a specific chat. Use when you need to fetch messages from a Campfire conversation in a Basecamp project.

Action Parameters

bucket_id
integerRequired
chat_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Campfire Line by ID

Description

Tool to retrieve a specific Campfire line by ID from a Basecamp project. Use when you need to fetch a single message from a chat transcript.

Action Parameters

bucket_id
integerRequired
chat_id
integerRequired
line_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Comment by ID

Description

Tool to retrieve a specific comment by ID from a Basecamp project. Use when you need to fetch details about a particular comment including its content, creator, and parent message.

Action Parameters

bucket_id
integerRequired
comment_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Document from Bucket

Description

Tool to retrieve a specific document from a Basecamp project bucket. Use when you need to get the full details of a document including its title, content, creator, and metadata.

Action Parameters

bucket_id
integerRequired
document_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Inbox

Description

Tool to retrieve a specific inbox from a Basecamp project. Use when you need to get details about a particular inbox, including its title, forwards count, and creator information.

Action Parameters

bucket_id
integerRequired
inbox_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Inbox Forwards

Description

Tool to retrieve a paginated list of active email forwards from a project's inbox. Use when you need to fetch forwarded emails in a Basecamp inbox.

Action Parameters

bucket_id
integerRequired
inbox_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Message Board from Project

Description

Tool to retrieve a specific message board from a Basecamp project. Use when you need details about a message board including its title, creator, message count, and message URLs.

Action Parameters

bucket_id
integerRequired
message_board_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Messages from Message Board

Description

Tool to retrieve a paginated list of active messages from a message board in a Basecamp project. Use when you need to fetch messages from a specific message board.

Action Parameters

bucket_id
integerRequired
message_board_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Message by ID

Description

Tool to retrieve a specific message by ID from a Basecamp project message board. Use when you need to fetch a single message including its content, title, creator, and associated comments.

Action Parameters

bucket_id
integerRequired
message_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Question Answer by ID

Description

Tool to retrieve a specific question answer by ID from a Basecamp project. Use when you need to fetch details about an automatic check-in question answer including its content, creator, and associated comments.

Action Parameters

answer_id
integerRequired
bucket_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Questionnaire

Description

Tool to retrieve a specific questionnaire (automatic check-ins) from a Basecamp project. Use when you need to fetch details about a questionnaire including its questions count and metadata.

Action Parameters

bucket_id
integerRequired
questionnaire_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Questions from Questionnaire

Description

Tool to retrieve a paginated list of questions from a questionnaire in a Basecamp project. Use when you need to fetch questions from a specific questionnaire.

Action Parameters

bucket_id
integerRequired
questionnaire_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Recording Comments

Description

Tool to retrieve a paginated list of active comments on a recording. Use when you need to fetch comments from a specific recording in a Basecamp project.

Action Parameters

bucket_id
integerRequired
recording_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Recording Events

Description

Tool to retrieve a paginated list of events for a recording. Use when you need to fetch change history from a specific recording in a Basecamp project.

Action Parameters

bucket_id
integerRequired
recording_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Recording Subscription

Description

Tool to retrieve subscription information for a recording. Use when you need to check if users are subscribed to a recording and get the list of all subscribers.

Action Parameters

bucket_id
integerRequired
recording_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Schedule Entry by ID

Description

Tool to retrieve a specific schedule entry by ID from a Basecamp project. Use when you need to get details about a scheduled event including its time, participants, and metadata.

Action Parameters

bucket_id
integerRequired
entry_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Schedule from Project

Description

Tool to retrieve a specific schedule from a Basecamp project. Use when you need details about a schedule including its entries count and entries URL.

Action Parameters

bucket_id
integerRequired
schedule_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Schedule Entries

Description

Tool to retrieve a paginated list of schedule entries from a schedule. Use when you need to fetch entries from a specific schedule in a Basecamp project.

Action Parameters

bucket_id
integerRequired
schedule_id
integerRequired
status
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get To-Do List

Description

Tool to retrieve a specific to-do list from a Basecamp project by its ID. Use when you need to get details about a to-do list including its title, description, completion status, and URLs for todos and groups.

Action Parameters

bucket_id
integerRequired
todolist_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get To-do List Groups

Description

Tool to retrieve a paginated list of active groups from a to-do list in a Basecamp project. Use when you need to list all groups within a specific to-do list for organizing tasks.

Action Parameters

bucket_id
integerRequired
status
string
todolist_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get To-Dos from To-Do List

Description

Tool to retrieve a paginated list of to-dos from a specific to-do list in a Basecamp project. Use when you need to fetch to-do items from a to-do list, optionally filtering by status or completion state.

Action Parameters

bucket_id
integerRequired
completed
boolean
status
string
todolist_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get To-Do by ID

Description

Tool to retrieve a specific to-do by ID from a Basecamp project. Use when you need to fetch a single to-do item including its content, title, assignees, completion status, and dates.

Action Parameters

bucket_id
integerRequired
todo_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get To-Do Set

Description

Tool to retrieve a specific to-do set from a Basecamp project. Use when you need to get details about a to-do set, including its completion status, to-do lists count, and associated URLs.

Action Parameters

bucket_id
integerRequired
todoset_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Todoset To-Do Lists

Description

Tool to retrieve a paginated list of to-do lists within a specific to-do set in a Basecamp project. Use when you need to fetch all to-do lists from a to-do set, optionally filtering by status.

Action Parameters

bucket_id
integerRequired
status
string
todoset_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Upload by ID

Description

Tool to retrieve a specific upload by ID from a Basecamp project vault. Use when you need to fetch details about an uploaded file including its metadata, download URL, and dimensions.

Action Parameters

bucket_id
integerRequired
upload_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Vault from Project

Description

Tool to retrieve a specific vault from a Basecamp project. Use when you need details about a vault including its documents, uploads, and nested vaults.

Action Parameters

bucket_id
integerRequired
vault_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Documents from Vault

Description

Tool to retrieve a paginated list of active documents from a vault in a Basecamp project. Use when you need to fetch all documents stored in a specific vault.

Action Parameters

bucket_id
integerRequired
page
integer
vault_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Uploads from Vault

Description

Tool to retrieve a paginated list of active uploads from a vault in a Basecamp project. Use when you need to fetch all uploaded files stored in a specific vault.

Action Parameters

bucket_id
integerRequired
page
integer
vault_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Vaults from Parent Vault

Description

Tool to retrieve a paginated list of vaults nested within a parent vault in a Basecamp project. Use when you need to fetch child vaults from a specific vault.

Action Parameters

bucket_id
integerRequired
vault_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Project Webhooks

Description

Tool to retrieve all webhooks configured for a Basecamp project. Use when you need to list all webhook configurations including their payload URLs, event types, and active status.

Action Parameters

bucket_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Campfire

Description

Tool to retrieve a specific Campfire (chat room) by ID from a Basecamp project. Use when you need to get complete Campfire details including metadata, URLs, topic, and creator information.

Action Parameters

bucket_id
integerRequired
campfire_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Campfire Line

Description

Tool to retrieve a specific Campfire line by ID from a Basecamp project. Use when you need to fetch a single message from a chat transcript.

Action Parameters

bucket_id
integerRequired
chat_id
integerRequired
line_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get a specific card by ID

Description

Tool to get a specific card by ID from a card table. Use when you need to retrieve complete card details including title, description, status, assignees, steps, and metadata.

Action Parameters

bucket_id
integerRequired
card_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get card table (Kanban board)

Description

Tool to retrieve a card table (Kanban board) for a project. Use when you need to fetch information about a specific card table including its columns, cards count, and subscribers.

Action Parameters

bucket_id
integerRequired
card_table_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Card Table Column

Description

Tool to get a specific column from a card table within a Basecamp project. Use when you need to fetch details about a card table column by its ID.

Action Parameters

bucket_id
integerRequired
column_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Chatbot by ID

Description

Tool to get a specific chatbot by ID from a Basecamp Campfire chat. Use when you need to retrieve details about a chatbot, including its service name, command URL, and lines URL.

Action Parameters

bucket_id
integerRequired
chat_id
integerRequired
chatbot_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Chats

Description

Tool to retrieve a paginated list of all active Campfires (chats) visible to the current user. Use when you need to list all available chat rooms in Basecamp.

Action Parameters

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Circles People

Description

Tool to retrieve all people on this Basecamp account who can be pinged. Use when you need to get a list of all pingable users in the account.

Action Parameters

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Comment

Description

Tool to retrieve a specific comment by ID from a Basecamp project. Use when you need to fetch details about a particular comment including its content, creator, and parent resource.

Action Parameters

bucket_id
integerRequired
comment_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Document by ID

Description

Tool to get a specific document by ID from a Basecamp project bucket. Use when you need to retrieve complete document details including title, content, creator, metadata, and comments count.

Action Parameters

bucket_id
integerRequired
document_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Inbox

Description

Tool to get the inbox (email forwards) for a Basecamp project. Use when you need to retrieve details about a specific inbox including its forwards count and metadata.

Action Parameters

bucket_id
integerRequired
inbox_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Message by ID

Description

Tool to retrieve a specific message by ID from a Basecamp project message board. Use when you need to fetch details of a single message including its content, author, and metadata.

Action Parameters

bucket_id
integerRequired
message_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Message Board

Description

Tool to get the message board for a project. Use when you need to retrieve details about a specific message board including its title, creator, message count, and URLs.

Action Parameters

bucket_id
integerRequired
message_board_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Message Type by ID

Description

Tool to retrieve a specific message type by ID from a Basecamp project. Use when you need details about a specific message type/category.

Action Parameters

bucket_id
integerRequired
category_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get My Profile

Description

Tool to retrieve the current user's personal info including profile details, permissions, and settings. Use when you need to get information about the authenticated user.

Action Parameters

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get All People

Description

Tool to retrieve all people visible to the current user in the Basecamp account. Use when you need to list users, check permissions, or get contact information for team members.

Action Parameters

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Person by ID

Description

Tool to retrieve the profile for a specific user by their ID. Use when you need to get detailed information about a specific person in the Basecamp account.

Action Parameters

person_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Person Profile

Description

Tool to retrieve a specific person's profile by their ID. Use when you need detailed information about a specific person in the Basecamp account.

Action Parameters

person_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Project

Description

Tool to retrieve a specific project by its ID with complete details. Use when you need to get comprehensive information about a particular project including its status, metadata, and dock tools configuration.

Action Parameters

project_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Projects

Description

Tool to retrieve a paginated list of projects visible to the current user, sorted by most recently created first. Use when you need to list all projects, filter by status (active/archived/trashed), or access project details.

Action Parameters

status
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Project by ID

Description

Tool to retrieve a single project by its ID with full details including dock tools. Use when you need to get information about a specific project that the user has access to.

Action Parameters

project_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Projects People

Description

Tool to retrieve all active people assigned to a Basecamp project. Use when you need to list all members who have access to a specific project.

Action Parameters

project_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Projects Recordings

Description

Tool to retrieve a paginated list of records for a given type of recording across projects. Use when you need to list recordings of a specific type (Message, Document, Todo, etc.) with optional filtering by project, status, and sorting.

Action Parameters

bucket
string
direction
string
recording_type
stringRequired
sort
string
status
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Timesheet Report

Description

Tool to retrieve all timesheet entries across the Basecamp account within a given timeframe. Use when you need to generate time reports, track hours logged, or analyze time entries by person or project. Without date parameters, returns only the last month of entries.

Action Parameters

bucket_id
integer
end_date
string
person_id
integer
start_date
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Schedule for Project

Description

Tool to retrieve schedule details for a specific project. Use when you need information about a schedule including entries count and configuration.

Action Parameters

bucket_id
integerRequired
schedule_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Schedule Entry

Description

Tool to get a specific schedule entry by ID from a Basecamp project. Use when you need to retrieve details about a scheduled event including its time, participants, and metadata.

Action Parameters

bucket_id
integerRequired
entry_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Subscription

Description

Tool to get subscription information for a recording. Use when you need to check subscription status, view subscriber count, or get detailed information about all subscribers for a specific recording.

Action Parameters

bucket_id
integerRequired
recording_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Templates

Description

Tool to retrieve a paginated list of active templates visible to the current user, sorted by most recently created first. Use when you need to list templates or filter by status (active/archived/trashed).

Action Parameters

status
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Template by ID

Description

Tool to retrieve a single template by its ID with full details including dock tools. Use when you need to get information about a specific template that the user has access to.

Action Parameters

template_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Project Construction Status

Description

Tool to retrieve the status of a project construction from a template. Use when you need to monitor the progress of a project being created from a template. Can be polled at intervals (no more than once per second) to track construction status.

Action Parameters

construction_id
integerRequired
template_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get To-Do by ID

Description

Tool to retrieve a specific to-do by ID from a Basecamp project. Use when you need to fetch detailed information about a single to-do item including its content, title, assignees, completion status, dates, and parent relationships.

Action Parameters

bucket_id
integerRequired
todo_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get To-Do List

Description

Tool to retrieve a specific to-do list from a Basecamp project by its ID. Use when you need to get details about a to-do list including its title, description, completion status, and URLs for todos and groups.

Action Parameters

bucket_id
integerRequired
todolist_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get To-Do List Groups

Description

Tool to retrieve a paginated list of groups from a to-do list in a Basecamp project. Use when you need to list groups (sub-sections) within a specific to-do list for organizing tasks.

Action Parameters

bucket_id
integerRequired
status
string
todolist_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get To-Do Set

Description

Tool to retrieve a specific to-do set from a Basecamp project. Use when you need to get details about a to-do set, including its completion status and to-do lists count.

Action Parameters

bucket_id
integerRequired
todoset_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Upload

Description

Tool to get a specific upload by ID from a Basecamp project. Use when you need to retrieve details about an uploaded file including metadata, download URL, and dimensions.

Action Parameters

bucket_id
integerRequired
upload_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Vault by ID

Description

Tool to retrieve a specific vault by ID from a Basecamp project. Use when you need details about a vault including its documents, uploads, and nested vaults.

Action Parameters

bucket_id
integerRequired
vault_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Webhook by ID

Description

Tool to retrieve a specific webhook by ID from a Basecamp project. Use when you need details about a webhook including its delivery history.

Action Parameters

bucket_id
integerRequired
webhook_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List Campfire Lines

Description

Tool to get all lines (messages) in a Campfire chat. Use when you need to fetch paginated messages from a Campfire conversation in a Basecamp project.

Action Parameters

bucket_id
integerRequired
chat_id
integerRequired
page
integer

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List Cards in Column

Description

Tool to get all cards in a column from a Basecamp card table. Use when you need to retrieve cards from a specific column/list within a project's card table.

Action Parameters

bucket_id
integerRequired
column_id
integerRequired
page
integer

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List Chatbots

Description

Tool to get all chatbots for a chat/campfire. Use when you need to retrieve the list of chatbot integrations with their line URLs for posting messages.

Action Parameters

bucket_id
integerRequired
chat_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List Comments

Description

Tool to get all comments on a recording in a Basecamp project. Use when you need to retrieve the list of active comments with their content, creators, and metadata.

Action Parameters

bucket_id
integerRequired
recording_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List Recording Events

Description

Tool to get all events (history) for a recording. Use when you need to retrieve the complete modification history of a specific recording in a Basecamp project.

Action Parameters

bucket_id
integerRequired
recording_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List Forwards

Description

Tool to get all email forwards in an inbox. Use when you need to retrieve forwarded emails from a Basecamp project inbox.

Action Parameters

bucket_id
integerRequired
inbox_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List Message Types

Description

Tool to retrieve all message types in a Basecamp project. Use when you need to list all available message types for organizing messages in a project.

Action Parameters

bucket_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List Project People

Description

Tool to get all people on a specific Basecamp project. Use when you need to retrieve the list of active members who have access to a particular project.

Action Parameters

project_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List Questions

Description

Tool to get all questions in a questionnaire from a Basecamp project. Use when you need to fetch questions from a specific questionnaire.

Action Parameters

bucket_id
integerRequired
questionnaire_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List To-Do Lists in To-Do Set

Description

Tool to get all to-do lists in a to-do set within a Basecamp project. Use when you need to retrieve all to-do lists from a specific to-do set, optionally filtering by status (archived or trashed).

Action Parameters

bucket_id
integerRequired
status
string
todoset_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List Uploads from Vault

Description

Tool to retrieve all active uploads from a vault in a Basecamp project. Use when you need to list all uploaded files stored in a specific vault.

Action Parameters

bucket_id
integerRequired
page
integer
vault_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List Vaults in Parent Vault

Description

Tool to retrieve all vaults (folders) nested within a parent vault in a Basecamp project. Use when you need to list child vaults from a specific vault.

Action Parameters

bucket_id
integerRequired
vault_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Move Card to Column

Description

Tool to move a card to a different column within a Basecamp card table. Use when you need to relocate a card from one column to another in a project.

Action Parameters

bucket_id
integerRequired
card_id
integerRequired
column_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Reorder Card Table Column

Description

Tool to reorder columns within a Basecamp card table. Use when you need to change the position of a column in a card table by specifying the column to move and its new position.

Action Parameters

bucket_id
integerRequired
card_table_id
integerRequired
position
integerDefaults to 1
source_id
integerRequired
target_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Pin Message

Description

Tool to pin a message to the top of the message board. Use when you need to feature a message prominently at the top of a message board in a project.

Action Parameters

bucket_id
integerRequired
message_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Upload File Attachment

Description

Tool to upload a file to Basecamp system. Use when you need to upload a file to get an attachable_sgid reference for use in other operations like creating messages or todos with attachments.

Action Parameters

file
objectRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Move Card to Column

Description

Tool to move a card to a different column within a Basecamp card table. Use when you need to relocate a card from one column to another in a project.

Action Parameters

bucket_id
integerRequired
card_id
integerRequired
column_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Reposition Step in Card

Description

Tool to reposition a step within a card in a Basecamp card table. Use when you need to change the order of steps/subtasks within a card by moving a step to a specific position.

Action Parameters

bucket_id
integerRequired
card_id
integerRequired
position
integerRequired
source_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create Step in Card

Description

Tool to create a step within a card in a Basecamp card table. Use when you need to add a subtask or checklist item to an existing card with optional due date and assignees.

Action Parameters

assignees
string
bucket_id
integerRequired
card_id
integerRequired
due_on
string
title
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create Card Table Column

Description

Tool to create a column within a Basecamp card table. Use when you need to add a new column to organize cards in a card table project.

Action Parameters

bucket_id
integerRequired
card_table_id
integerRequired
description
string
title
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create On-Hold Section in Column

Description

Tool to create an on-hold section in a card table column. Use when you need to add an on-hold area to organize cards that are temporarily paused or waiting.

Action Parameters

bucket_id
integerRequired
column_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create Card in Card Table

Description

Tool to create a card within a specified column in a Basecamp Card Table project. Use when you need to add a new card to a card table list with optional content and due date.

Action Parameters

bucket_id
integerRequired
content
string
due_on
string
list_id
integerRequired
notify
boolean
title
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Subscribe to Card Table Column

Description

Tool to subscribe to watch a card table column in a Basecamp project. Use when you need to start watching/subscribing to a specific column for notifications.

Action Parameters

bucket_id
integerRequired
list_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Reposition Card Table Column

Description

Tool to reposition a column within a Basecamp card table. Use when you need to change the order of columns in a card table.

Action Parameters

bucket_id
integerRequired
card_table_id
integerRequired
position
integerDefaults to 1
source_id
integerRequired
target_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create Message Category

Description

Tool to create a new message type (category) in a Basecamp project. Use when you need to create a custom message category for organizing different types of messages in a project.

Action Parameters

bucket_id
integerRequired
icon
stringRequired
name
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create Campfire Chatbot Integration

Description

Tool to create a chatbot integration in a Basecamp Campfire chat. Use when you need to add a new chatbot to a chat room, which allows automated posting of messages. Requires admin permissions.

Action Parameters

bucket_id
integerRequired
chat_id
integerRequired
command_url
string
service_name
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create Campfire Line

Description

Tool to create a line in a Basecamp Campfire chat. Use when you need to post a message to a specific Campfire chat within a project.

Action Parameters

bucket_id
integerRequired
chat_id
integerRequired
content
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create Message on Message Board

Description

Tool to publish a message to a Basecamp message board within a project. Use when you need to create a new message with optional rich HTML content and subscriptions.

Action Parameters

bucket_id
integerRequired
category_id
integer
content
string
message_board_id
integerRequired
status
stringRequired
subject
stringRequired
subscriptions
array

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create Comment on Recording

Description

Tool to publish a comment on a recording within a Basecamp project. Use when you need to add a comment with rich text to any recording such as a todolist, message, or document.

Action Parameters

bucket_id
integerRequired
content
stringRequired
recording_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Pin Recording

Description

Tool to pin a recording (message) in a Basecamp project. Use when you need to feature a message prominently at the top of a message board or project.

Action Parameters

bucket_id
integerRequired
recording_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Subscribe to Recording

Description

Tool to subscribe the current user to a recording for notifications. Use when you need to start watching/subscribing to a specific recording to receive notifications for new comments.

Action Parameters

bucket_id
integerRequired
recording_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create Schedule Entry

Description

Tool to create a schedule entry in a Basecamp schedule within a project. Use when you need to add a new event with start/end times and optional participants.

Action Parameters

all_day
boolean
bucket_id
integerRequired
description
string
ends_at
stringRequired
notify
boolean
participant_ids
array
schedule_id
integerRequired
starts_at
stringRequired
summary
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create To-Do List Group

Description

Tool to create a to-do list group within a specified to-do list in a Basecamp project. Use when you need to organize todos into groups with optional color coding.

Action Parameters

bucket_id
integerRequired
color
string
name
stringRequired
todolist_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create To-Do in To-Do List

Description

Tool to create a to-do in a Basecamp to-do list within a project. Use when you need to add a new to-do item with optional description, assignees, and due date.

Action Parameters

assignee_ids
array
bucket_id
integerRequired
completion_subscriber_ids
array
content
stringRequired
description
string
due_on
string
notify
boolean
starts_on
string
todolist_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Mark To-Do as Completed

Description

Tool to mark a pending to-do as completed in Basecamp. Use when you need to complete a to-do item. Completion subscribers will be notified when this action is performed.

Action Parameters

bucket_id
integerRequired
todo_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create To-Do List in To-Do Set

Description

Tool to create a new to-do list in a Basecamp to-do set within a project. Use when you need to add a new to-do list with optional HTML description.

Action Parameters

bucket_id
integerRequired
description
string
name
stringRequired
todoset_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create Document in Vault

Description

Tool to create a document in a Basecamp vault. Use when you need to publish a document in a specific project vault with title, content, and optional status.

Action Parameters

bucket_id
integerRequired
content
stringRequired
status
string
title
stringRequired
vault_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create Upload in Vault

Description

Tool to create an upload in a Basecamp vault. Use when you need to create an upload entry for a previously uploaded attachment in a specific project vault.

Action Parameters

attachable_sgid
stringRequired
base_name
string
bucket_id
integerRequired
description
string
vault_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create Nested Vault

Description

Tool to create a nested vault under an existing vault in a Basecamp project. Use when you need to organize documents and files hierarchically by creating sub-vaults within parent vaults.

Action Parameters

bucket_id
integerRequired
title
stringRequired
vault_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create Webhook

Description

Tool to create a new webhook subscription for a Basecamp project. Use when you need to receive event notifications at a specified HTTPS endpoint for project activities.

Action Parameters

bucket_id
integerRequired
payload_url
stringRequired
types
array

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create Campfire Line via Chatbot

Description

Tool to create a line in a Basecamp Campfire chat using a chatbot key. Use when you need to post messages via a chatbot integration without OAuth authentication.

Action Parameters

bucket_id
integerRequired
chat_id
integerRequired
chatbot_key
stringRequired
content
stringRequired
content_param
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create Lineup Marker

Description

Tool to create an account-wide marker that shows up in the Lineup. Use when you need to add a visual marker to highlight important dates or milestones across all projects.

Action Parameters

date
stringRequired
name
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create New Project

Description

Tool to create a new project in Basecamp with a name and optional description. Use when you need to set up a new project workspace for team collaboration.

Action Parameters

description
string
name
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create New Template

Description

Tool to create a new template in Basecamp with a name and optional description. Use when you need to set up a reusable project template for standardizing workflows.

Action Parameters

description
string
name
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create Project from Template

Description

Tool to create a new project from a Basecamp template with a project name and optional description. Use when you need to instantiate a project based on an existing template.

Action Parameters

project
objectRequired
template_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Update Card in Card Table

Description

Tool to update an existing card in a Basecamp card table. Use when you need to modify a card's title, content, due date, or assignees. Omitted parameters remain unchanged.

Action Parameters

assignee_ids
array
bucket_id
integerRequired
card_id
integerRequired
content
string
due_on
string
title
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Update Card Table Column

Description

Tool to update a card table column in a Basecamp project. Use when you need to modify a column's title or description. Omitted parameters remain unchanged.

Action Parameters

bucket_id
integerRequired
column_id
integerRequired
description
string
title
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Update Card Table Column Color

Description

Tool to update a card table column's visual color designation in a Basecamp project. Use when you need to change the color of a specific column for better visual organization.

Action Parameters

bucket_id
integerRequired
color
stringRequired
column_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Update Card Table Step

Description

Tool to update an existing card table step in Basecamp. Use when you need to modify a step's title, due date, or assignees. Omitted parameters remain unchanged.

Action Parameters

assignees
string
bucket_id
integerRequired
due_on
string
step_id
integerRequired
title
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Mark Step Completion Status

Description

Tool to mark a card table step as completed or uncompleted in Basecamp. Use when you need to toggle the completion status of a step by setting completion to "on" or "off".

Action Parameters

bucket_id
integerRequired
completion
stringRequired
step_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Update Message Category

Description

Tool to update an existing message type (category) in a Basecamp project. Use when you need to modify the name or icon of a message category.

Action Parameters

bucket_id
integerRequired
category_id
integerRequired
icon
stringRequired
name
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Update Chatbot Integration

Description

Tool to update an existing chatbot integration in a Basecamp Campfire chat. Use when you need to change the service name or command URL of a chatbot.

Action Parameters

bucket_id
integerRequired
chat_id
integerRequired
command_url
string
integration_id
integerRequired
service_name
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Update Comment

Description

Tool to update comment content in a Basecamp project. Use when you need to modify the content of an existing comment.

Action Parameters

bucket_id
integerRequired
comment_id
integerRequired
content
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Update Document in Bucket

Description

Tool to update an existing document in a Basecamp project bucket. Use when you need to modify a document's title, content, or both. Omitted parameters remain unchanged.

Action Parameters

bucket_id
integerRequired
content
string
document_id
integerRequired
title
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Update Message

Description

Tool to update a message's subject, content, or category in a Basecamp project. Use when you need to modify an existing message's title, body text, or categorization.

Action Parameters

bucket_id
integerRequired
category_id
integer
content
string
message_id
integerRequired
subject
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Update Recording Client Visibility

Description

Tool to update client visibility for a recording in Basecamp. Use when you need to show or hide a recording from clients. Returns 403 if the recording inherits visibility from parent resource.

Action Parameters

bucket_id
integerRequired
recording_id
integerRequired
visible_to_clients
booleanRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Unarchive Recording

Description

Tool to unarchive a recording in a Basecamp project by marking it as active. Use when you need to restore an archived recording to make it visible again in the project.

Action Parameters

bucket_id
integerRequired
recording_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Archive Recording

Description

Tool to mark a recording as archived in a Basecamp project. Use when you need to archive a recording to remove it from active view while preserving it for reference.

Action Parameters

bucket_id
integerRequired
recording_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Trash Recording

Description

Tool to mark a recording as trashed in a Basecamp project. Use when you need to move a recording to trash without permanently deleting it.

Action Parameters

bucket_id
integerRequired
recording_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Update Recording Subscription

Description

Tool to update recording subscriptions by adding or removing subscribers. Use when you need to manage who receives notifications for a specific recording. At least one of subscriptions or unsubscriptions must be provided.

Action Parameters

bucket_id
integerRequired
recording_id
integerRequired
subscriptions
array
unsubscriptions
array

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Update Schedule Entry

Description

Tool to update an existing schedule entry in a Basecamp schedule. Use when you need to modify an entry's title, times, description, or participants. Omitted parameters remain unchanged.

Action Parameters

all_day
boolean
bucket_id
integerRequired
description
string
ends_at
string
entry_id
integerRequired
notify
boolean
participant_ids
array
starts_at
string
summary
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Update Schedule Configuration

Description

Tool to update a schedule configuration in a Basecamp project. Use when you need to change whether the schedule includes due assignments from to-dos, cards and steps.

Action Parameters

bucket_id
integerRequired
include_due_assignments
booleanRequired
schedule_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Reposition To-Do List Group

Description

Tool to reposition a to-do list group within its parent to-do list in a Basecamp project. Use when you need to change the order of to-do list groups by moving a group to a specific position.

Action Parameters

bucket_id
integerRequired
group_id
integerRequired
position
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Update To-Do in Bucket

Description

Tool to update an existing to-do in a Basecamp project. Use when you need to modify a to-do's content, description, assignees, dates, or notification settings. Note: Pass all existing parameters along with those being updated to prevent clearing values.

Action Parameters

assignee_ids
array
bucket_id
integerRequired
completion_subscriber_ids
array
content
stringRequired
description
string
due_on
string
notify
boolean
starts_on
string
todo_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Reposition To-Do

Description

Tool to change the position of a to-do within its list in a Basecamp project. Use when you need to reorder to-dos by moving a specific to-do to a new position.

Action Parameters

bucket_id
integerRequired
position
integerRequired
todo_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Update Upload in Bucket

Description

Tool to update an existing upload in a Basecamp project bucket. Use when you need to modify an upload's description or filename. Omitted parameters remain unchanged.

Action Parameters

base_name
string
bucket_id
integerRequired
description
string
upload_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Update Vault Title

Description

Tool to update a vault's title in a Basecamp project. Use when you need to rename a vault within a specific project bucket.

Action Parameters

bucket_id
integerRequired
title
stringRequired
vault_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Update Webhook

Description

Tool to update an existing webhook in a Basecamp project. Use when you need to modify the webhook's URL, event types, or active status.

Action Parameters

active
boolean
bucket_id
integerRequired
payload_url
stringRequired
types
array
webhook_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Update Project

Description

Tool to update an existing project's name, description, access policy, or schedule in Basecamp. Use when you need to modify project details or settings. Note: name parameter is required; schedule dates must be provided as pairs (both start_date and end_date).

Action Parameters

admissions
string
description
string
name
stringRequired
project_id
integerRequired
schedule_attributes
object

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Grant or Revoke Project Access

Description

Tool to grant or revoke project access for users in Basecamp. Use when you need to add existing users to a project, create new users with access, or remove users from a project. At least one of grant, revoke, or create must be provided.

Action Parameters

create
array
grant
array
project_id
integerRequired
revoke
array

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Update Template

Description

Tool to update a template's name and description in Basecamp. Use when you need to modify template metadata. Omitted parameters remain unchanged.

Action Parameters

description
string
name
string
template_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Reposition Card Step

Description

Tool to change the position of a step within a card. Use when you need to reorder steps in a card table card by moving a step to a specific position.

Action Parameters

bucket_id
integerRequired
card_id
integerRequired
position
integerRequired
source_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Subscribe Current User to Recording

Description

Tool to subscribe the current authenticated user to a recording for notifications. Use when you need to add the current user to the subscriber list to receive updates about the recording.

Action Parameters

bucket_id
integerRequired
recording_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Toggle Client Visibility

Description

Tool to change client visibility for a recording in Basecamp. Use when you need to show or hide a recording from clients. Returns 403 error if the recording doesn't control its own visibility.

Action Parameters

bucket_id
integerRequired
recording_id
integerRequired
visible_to_clients
booleanRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Trash Project

Description

Tool to mark a Basecamp project as trashed. Use when you need to trash a project. Trashed projects will be permanently deleted after 30 days.

Action Parameters

project_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Trash Template

Description

Tool to mark a template as trashed in Basecamp. Use when you need to soft-delete a template; it will be permanently removed after 30 days.

Action Parameters

template_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Uncomplete To-Do

Description

Tool to mark a to-do as uncompleted in Basecamp. Use when you need to reverse the completion status of a completed to-do item.

Action Parameters

bucket_id
integerRequired
todo_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Unpin Message

Description

Tool to unpin a message from the message board. Use when you need to remove the pinned status from a message that was previously pinned to the top of a message board.

Action Parameters

bucket_id
integerRequired
message_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Unsubscribe Current User from Recording

Description

Tool to unsubscribe the current user from a recording. Use when you need to stop receiving notifications for a specific recording. This is an idempotent operation that returns success even if the user wasn't previously subscribed.

Action Parameters

bucket_id
integerRequired
recording_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Stop Watching Card Table Column

Description

Tool to stop watching a card table column. Use when you want to unsubscribe from a specific column and no longer receive notifications about changes to it.

Action Parameters

bucket_id
integerRequired
column_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Update Card

Description

Tool to update a card's details in a Basecamp card table. Use when you need to modify a card's title, content, due date, or assignees.

Action Parameters

assignee_ids
array
bucket_id
integerRequired
card_id
integerRequired
content
string
due_on
string
title
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Update Card Table Column

Description

Tool to update a card table column's properties in a Basecamp project. Use when you need to modify a column's title or description.

Action Parameters

bucket_id
integerRequired
column_id
integerRequired
description
string
title
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Update Chatbot

Description

Tool to update a chatbot's service name or command URL in a Basecamp Campfire chat. Use when you need to modify an existing chatbot integration.

Action Parameters

bucket_id
integerRequired
chat_id
integerRequired
chatbot_id
integerRequired
command_url
string
service_name
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Update Document

Description

Tool to update an existing document's title or content in a Basecamp project. Use when you need to modify document title, content, or both.

Action Parameters

bucket_id
integerRequired
content
string
document_id
integerRequired
title
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Update Message Type

Description

Tool to update an existing message type in a Basecamp project. Use when you need to modify the name or icon of a message category.

Action Parameters

bucket_id
integerRequired
category_id
integerRequired
icon
string
name
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Update Schedule Entry

Description

Tool to update an existing schedule entry in a Basecamp project schedule. Use when you need to modify details like title, dates, description, or participants. Omitted parameters remain unchanged.

Action Parameters

all_day
boolean
bucket_id
integerRequired
description
string
ends_at
string
entry_id
integerRequired
notify
boolean
participant_ids
array
starts_at
string
summary
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Update To-Do

Description

Tool to update a to-do's content, assignees, or due date in a Basecamp project. Use when you need to modify an existing to-do item. Pass all existing parameters along with those being updated to prevent clearing values.

Action Parameters

assignee_ids
array
bucket_id
integerRequired
completion_subscriber_ids
array
content
stringRequired
description
string
due_on
string
notify
boolean
starts_on
string
todo_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Update Upload

Description

Tool to update an upload's description or filename in a Basecamp bucket. Use when you need to modify upload metadata without re-uploading the file.

Action Parameters

base_name
string
bucket_id
integerRequired
description
string
upload_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Update Vault Title

Description

Tool to update a vault's title in a Basecamp project. Use when you need to rename a vault within a specific project bucket.

Action Parameters

bucket_id
integerRequired
title
stringRequired
vault_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Watch Card Table Column

Description

Tool to start watching a card table column in a Basecamp project. Use when you need to subscribe to a specific column to receive notifications about changes.

Action Parameters

bucket_id
integerRequired
column_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired