Read a Basecamp card or todo with optional comments and images. Supports any Basecamp URL.

Post a comment to any Basecamp card or todo. Can include attachments by providing attachment_sgids.

Upload a file (image, video, document) to Basecamp. Returns an attachable_sgid that can be used in comments, messages, or any rich text content.

Post a comment with an attached file (image, video, document) to any Basecamp card or todo. Automatically uploads the file and embeds it in one step.

List all Basecamp projects

Get detailed information about a specific project

Create a new Basecamp project

Update a project name, description, access policy, or schedule dates

Get a clean map of all dock tool IDs for a project (message_board, todoset, vault, chat, schedule, questionnaire, inbox, kanban_board). Use this to quickly find tool IDs needed by other endpoints.

Move a project to trash

List all columns in a card table

Get detailed information about a specific column (including subscribers, color, cards count)

Create a new column in a card table

Update a column title or description

List cards in a column. Defaults to auto-paginating — walks every page via Link headers so a 224-card Done column returns as one array instead of the first 15 rows. Pass {single_page: true, page: N} to restrict to a single page (useful for UI-style pagination).

Compact card listing for iteration — returns only id, title, status, app_url, timestamps, comment count, assignee names, and completed flag for every card in a column. Payload is ~5% of list_cards so this is the right tool when you just need to walk IDs (e.g. to feed basecamp_get_card in a loop over the Done column). Always auto-paginates.

Get detailed information about a specific card

Create a new card in a specific column. Can include attachments by providing attachment_sgids.

Update an existing card (title, content, assignees, due date, completion). Can include attachments.

Move a card to a different column (status change)

Move a card to trash

Change the color of a card table column. Available colors: white, red, orange, yellow, green, blue, aqua, purple, gray, pink, brown

Move/reorder a column within a card table

Start watching/subscribing to a column for notifications

Stop watching/subscribing to a column

Add an on-hold section to a column

Remove the on-hold section from a column

List all steps/checklist items on a card

Add a new step to a card

Update a step title, due date, or assignees

Mark a step as completed

Mark a step as incomplete

Change the position of a step within a card

List all people in the organization

Get details about a specific person

Get a specific todo item

Create a new todo item

Mark a todo as completed

Mark a todo as incomplete

Get recent activity/events for the account or a specific project

Find a project by name using fuzzy matching

Get the To-do Set for a project (contains all todo lists)

List all to-do lists in a project

Get details of a specific to-do list

Create a new to-do list in a project

Update a to-do list

List all to-dos in a to-do list

Get details of a specific to-do

Create a new to-do in a to-do list

Update a to-do

Mark a to-do as completed

Mark a to-do as incomplete

List all messages in a message board

Get a specific message with full content

Post a new message/announcement to the message board. Can include images and videos.

Update an existing message

Pin a message to the top of the message board

Unpin a message from the message board

List all sub-vaults (folders) within a vault

Get details of a specific vault (folder)

Create a new sub-vault (folder) within a vault

Rename a vault (folder)

List all documents in a vault (Docs & Files)

Get a specific document with full content

Create a new document in the vault

Update an existing document

List all file uploads in a vault

Get details of a specific file upload

Create a file upload in a vault. First use basecamp_upload_attachment to get an attachable_sgid, then use this to place it in a vault.

Update a file upload description or name

List all schedule entries (calendar events) in a project

Get a specific schedule entry/event

Create a new calendar event in the schedule

Update a schedule entry/event

List all Campfires (group chats) visible to the current user

Get details of a specific Campfire chat

List chat messages/lines in a Campfire

Post a new message to a Campfire chat. Can include images and videos.

Delete a chat message/line from a Campfire

List all people who can be pinged (mentioned) on this Basecamp account

Grant or revoke project access for people

Trash any Basecamp recording (card, todo, message, document, etc.)

Archive any Basecamp recording

Reactivate a trashed or archived Basecamp recording

Build full index of all projects, card tables, and columns for fast lookups

Update index for a specific project

Search projects by name in the index (fast lookup)

Get project details from index (project ID, card tables, columns)

Find a column by name within a project (fast lookup)

Get all columns for a project from index

Get index statistics (total projects, columns, last update time)

Parse a Basecamp URL to extract IDs (account, project, card/todo)