Basecamp MCP server for your AI

The column id comes from basecamp_get_card_table.

Get a card by ID

The card table id is tool_ids.kanban_board of basecamp_get_project.

The column id comes from basecamp_get_card_table.

column_id may be a column of another card table in the same project.

Update an existing card

Marks the to-do done.

The folder id is tool_ids.vault of basecamp_get_project, or from basecamp_list_vaults.

The to-do list id comes from basecamp_list_todolists.

The to-do set id is tool_ids.todoset of basecamp_get_project.

Get a single document by id

The connected person, with the id and attachable_sgid other tools take.

Get a single todo by id

The folder id is tool_ids.vault of basecamp_get_project, or from basecamp_list_vaults.

Everyone visible in the account, with the id and attachable_sgid other tools take.

list project people

The to-do lists of a project's to-do set.

The to-dos of one to-do list: basecamp_list_todolists gives the list ids.

The folder id is tool_ids.vault of basecamp_get_project, or from basecamp_list_vaults.

Mark a todo as incomplete

Send only the fields to change: PopMCP reads the to-do first and sends everything else back, because Basecamp clears any field a plain update leaves out.

Works on any recording that takes comments: to-do, message, document, upload, card.

The message board id is tool_ids.message_board of basecamp_get_project.

Get a single message by id

Active, incomplete to-dos across all accessible projects, grouped by project (paginated).

Get every overdue to-do across all accessible projects, oldest-due-date-first.

Works on any recording that takes comments.

The message board id is tool_ids.message_board of basecamp_get_project.

The Campfire id is tool_ids.chat of basecamp_get_project.

The Campfire id is tool_ids.chat of basecamp_get_project, or from basecamp_list_campfires.

The schedule id is tool_ids.schedule of basecamp_get_project.

The schedule id is tool_ids.schedule of basecamp_get_project.

tool_ids in the answer holds the id of each tool switched on in the project (message_board, todoset, vault, schedule, chat, questionnaire, inbox, kanban_board): those ids are what the list and create tools take.

Start here: every project.

Moves any recording to the trash.

Add a card from a project and a column name.

Add a to-do from a project and a list name.

Read a stored file from its download_url.

Find a project by name, with its id and tool ids.

A project's logo or wallpaper.

A project's details, people, to-do lists, messages and recent activity in one call.

Every to-do list of a project with its to-dos.

Post a message to a project's message board.

Send a line to a project's Campfire.

Upload a file to a project's Docs & Files.

What is assigned to the connected person, split into priorities and non_priorities.

Get the current user's notifications (the "Hey!" menu in Basecamp 4).

Get upcoming schedule entries and assignable items within a date window.

Search across the whole account.

Get project timeline

Create a column in a card table

Create a step on a card

Add a wormhole to a card table: a standing shortcut that sends cards to a column on another card table, usually in another project.

Permanently delete a card table's wormhole, the shortcut that sends cards to another card table.

Disable on-hold section in a column

Enable on-hold section in a column

Get a card column by ID

Get a step by ID

Move a column to a slot within its card table.

Reposition a step within a card

Set the color of a column

Set card step completion status (PUT with completion: "on" to complete, "" to uncomplete)

Subscribe to a card column (watch for changes)

Unsubscribe from a card column (stop watching for changes)

Update an existing column

Update an existing step

Point a card table's wormhole, its shortcut for sending cards to another card table, at a different destination column

Send the file as JSON: file_name plus content_base64.

Create a new cloud file in a vault.

Create a new Google document in a vault.

Post a progress update on a todoset's hill chart.

Create a new group in a todolist

Create a to-do directly under a project's to-do set, outside any to-do list.

Two steps: basecamp_create_attachment gives the attachable_sgid this needs.

Replace an upload's file with a new version The recording keeps its id, its URL and its comments; the previous file becomes a past version.

Create a new vault (subfolder) in a vault

Disable out of office for a person.

Disable clients on a project 403 while the project still has any client users: revoke them first with UpdateProjectClientAccess.

Enable or replace out of office for a person.

Enable clients on a project so client users can be added to it A deliberate step separate from adding clients: it turns on the project's client-facing surface and applies the default client visibility (the timeline and most docked tools become client-visible; the card table, Campfire, and Doors stay private).

Add people to the Basecamp account and send each new person an invitation, optionally granting them several projects at once.

Get a single cloud file by id

Get a single Google document by id

Get the hill chart for a todoset

Get one progress update from a todoset's hill chart

Get the current user's preferences

Get the out of office status for a person

Get a person by ID

Get subscription information for a recording

get todolist

Get a todoset (container for todolists in a project)

Get a single upload by id

Get a single vault by id

Join the current person to an all-access project they can see the id of but are not on yet, when the project's admissions policy lets them in.

List people who can be assigned todos

List the progress updates on a todoset's hill chart, newest first.

list pingable people

list todolist groups

list upload versions

list vaults

Reposition a todo within its todolist, or move it into another list or the to-do set in the same project.

Reposition a to-do list within its to-do set.

Reposition a todolist group

Set how the current person sees one folder (vault) in Docs & Files: grid or list.

Subscribe the current user to a recording

Unsubscribe the current user from a recording

Send only the fields to change: PopMCP reads the file first and sends the rest back, because Basecamp clears any field left out.

Send only the fields to change: PopMCP reads the document first and sends the rest back, because Basecamp clears any field left out.

Send only the fields to change: PopMCP reads the document first and sends the rest back, because Basecamp clears any field left out.

Track or untrack todolists on a hill chart

Update the current user's preferences.

Name, title, bio, location, time zone and display settings.

Add or remove people on a project.

Update project client access (grant/revoke/create client users) The client-side counterpart to UpdateProjectAccess: grant adds existing client users by id, revoke removes client users, and create invites brand-new clients by email (name optional, defaulting to the address).

Update subscriptions by adding or removing specific users

Send only the fields to change: PopMCP reads the list first and sends the rest back, because Basecamp clears any field left out.

Update an existing upload

Update an existing vault

Create a new message type in a project

Delete a message type

Get a single comment by id

Get a message board

Get a single message type by id

Open cards with no due date across all accessible projects, grouped by project (paginated).

Get every automatic check-in answer across all accessible projects, newest-first.

Get every comment across all accessible projects, newest-first (paginated).

Completed cards across all accessible projects, grouped by project (paginated).

Completed to-dos across all accessible projects, grouped by project (paginated).

Get every file recording across all accessible projects, newest-first (paginated).

Get every inbox forward across all accessible projects, newest-first (paginated).

Get every message across all accessible projects, newest-first (paginated).

Cards parked in a project's "Not now" column across all accessible projects, grouped by project (paginated).

Incomplete cards in active columns across all accessible projects, grouped by project (paginated).

Get every overdue card across all accessible projects, oldest-due-date-first.

Open to-dos with no due date across all accessible projects, grouped by project (paginated).

Open, unassigned cards across all accessible projects, grouped by project (paginated).

Open, unassigned to-dos across all accessible projects, grouped by project (paginated).

list message types

Pin a message to the top of the message board

Unpin a message from the message board

Update an existing comment

Update an existing message

Update an existing message type

Create a new answer for a question

Send the file as JSON: file_name plus content_base64.

Create a new chatbot for a campfire

Create a project from a template (asynchronous)

Create a new question in a questionnaire

Create a new template

Create a card table template with the default columns

Start copying a to-do list or card table template into a project

Create an empty to-do list template

Templatify a to-do list or card table

Delete a campfire line; allowed for the line's creator or an admin.

Delete a chatbot

Delete a template (trash it)

Get a single answer by id

Get a campfire by ID

Get a campfire line by ID

Get a chatbot by ID

Get the status of a project construction

Get a single question by id

Get a questionnaire (automatic check-ins container) by id

Get a single template by id

Get the current status of a to-do list template copy

Get a templatification

list answers

list answers by person

list campfire uploads

list campfires

list chatbots

Get pending check-in reminders for the current user Returns questions that are pending a response from the authenticated user.

list question answerers

list questions

Get the account's card table templates

Get the account's to-do list templates

list templates

Pause a check-in question (stops sending reminders)

Post a line into a Campfire AS a chatbot, with the chatbot's own key.

Resume a paused check-in question (resumes sending reminders)

Update an existing answer

Update an existing campfire line; the content is always treated as rich text (HTML).

Update an existing chatbot

Update an existing question's title, schedule or both.

Update notification settings for a check-in question

Update an existing template

Create a timesheet entry on a recording

delete timesheet entry

Get timesheet for a specific project

Get timesheet for a specific recording

Get a schedule

Get a single schedule entry by id.

Get a specific occurrence of a recurring schedule entry

Get a single timesheet entry

Get account-wide timesheet report

Send only the fields to change: PopMCP reads the entry first and sends the rest back, because Basecamp clears any field left out.

Update schedule settings

Update a timesheet entry

Archive a project, removing it from the active project list (returns 204 No Content).

archive recording

Start copying a recording into another project; poll GetFiling for the result.

Create a new project

Get the state of a move or copy started by MoveRecording or CopyRecording.

Get any recording by id, whatever its type (to-do, message, document, upload, card, comment and more): the generic shape with type, title, status, parent and bucket.

list events

List the projects the current user has most recently visited, most recent visit first.

List the recordings whose rich text references this recording, newest first (the most recent 20).

List one type of content across projects.

Start moving a recording into another project; poll GetFiling for the result.

Move a document, upload or vault into another vault in its project, or reorder it in its own vault.

Record that the current user visited a project, moving it to the front of ListRecentProjects (returns 204 No Content).

Remove the project's logo (returns 204 even when absent).

Remove the project's wallpaper (returns 204 No Content).

Put a recording's card in the spotlight area on its project or template home page.

Trashes the whole project and everything in it; Basecamp deletes it for good after 30 days.

Restore a project to active status from trash as well as from the archive (returns 204 No Content).

Unarchive a recording (restore to active status)

Remove a recording from the spotlight area.

Send only the fields to change: PopMCP fills in the name and description from the project when you leave them out.

Send the image as JSON: file_name plus content_base64.

Send the image as JSON: file_name plus content_base64.

Mark a subtask as completed

Add an external link (a Figma file, a Dropbox folder, a GitHub repository or any address) to a project's External links section.

Create a tool in a project dock

Create a subtask under a to-do or a card Any other recording answers 403 Forbidden.

Remove a tool from the dock: deletes an external link or an empty extra tool, and disables any other tool (returns 204 No Content either way).

Delete a subtask On accounts where deleting is limited to admins and the creator, everyone else gets 403 Forbidden.

Disable a tool (hide it from the project dock)

Enable a tool (show it on the project dock)

Get a dock tool by id

Get a subtask by ID

List a recording's subtasks, in position order Only to-dos and cards hold subtasks; check for subtasks_count and subtasks_url on the parent's JSON.

Update (rename) an existing tool

Reposition a tool on the project dock

Move a subtask to a new position among its siblings

Mark a subtask as not completed

Update a subtask A partial update: every omitted parameter is left unchanged.

Create a boost on a specific event within a recording.

Create a gauge needle (progress update) for a project

Create a boost on a recording

Delete a boost

Destroy a gauge needle

Get a single boost

Get a single client approval by id

Get a single client correspondence by id

Get a single client reply by id

Get a gauge needle by ID

list client approvals

list client correspondences

list client replies

List boosts on a specific event within a recording.

List gauge needles for a project, ordered newest first.

List gauges across all projects the authenticated user has access to.

List boosts on a recording

Set client visibility for a recording

Enable or disable the gauge for a project.

Replace the content of a boost.

Update a gauge needle's description.

Remove a recording from Up Next (returns 204 No Content).

Get the current user's completed assignments.

Get the current user's assignments filtered by due date scope.

Add a recording to Up Next: the current user's ordered list of prioritized assignments (the priorities returned by GetMyAssignments).

Move an already-prioritized recording to a new 1-based position in Up Next (returns 204 No Content).

Bubble up a recording for the current user, resurfacing it in the current user's readings (the BC5 successor to "save").

Create a folder for the authenticated user and file the given projects into it.

Webhooks belong to one project: bucketId is the project id.

Remove the current user's bubble-up from a recording (returns 204 No Content).

Delete a folder and unpin its projects from the home screen (returns 204 No Content).

Delete a webhook

Get the account for the current access token

Who this connection signs in as and which Basecamp accounts it reaches: identity, accounts (product bc3 is Basecamp), scope (full or read) and when the token expires.

Get one folder, with the projects grouped inside it expanded under projects.

Get a forward by ID

Get a forward reply by ID

Get an inbox by ID

Get a person's activity timeline

Get account-wide activity feed (progress report)

Get a single webhook by id

Get todos assigned to a specific person

List the authenticated user's folders in home-screen order.

list forward replies

list forwards

Get the current user's current and scheduled bubble-ups (paginated, 50 per page).

Get overdue todos grouped by lateness

Webhooks belong to one project: bucketId is the project id.

mark as read

Remove the account logo.

Send the image as JSON: file_name plus content_base64.

Rename the current account.

Rename a folder.

Update an existing webhook

Bookmark a recording for the current user.

Create a new lineup marker.

Remove the current user's bookmark from a recording (returns 204 No Content).

Delete a lineup marker

Report whether the current user has bookmarked the recording.

List all lineup markers for the account

List the current user's bookmarks, most recently bookmarked first (paginated).

Update an existing lineup marker.

Create a Ping with people, or return the one that already holds exactly them.

Get a Ping by its id, which is its bucket's id.

Get Pings: the caller's active Pings that have a line in them, most recently updated first, in one unpaginated response.

Create an embed for a URL, or return the one Basecamp already has for it.

Get a calendar by its bucket id.

Get an embed by its sgid.

Get the authenticated user's note: a per-person notebook singleton at /my/notes.json.

Get search metadata (available filter options)

The account's event feed, oldest first.

Poll the authenticated agent's inbox for the items that addressed it (oldest first, strict item-id order); people receive 403.

Update a calendar's display color.

Replace the note's content, recording a new revision server-side.

List the current user's drafts across their active projects, most recently updated first (paginated, capped at 250 like /my/assignments).