How to integrate Basecamp MCP with Google ADK

Connect Google ADK to Basecamp MCP. Create a new project for client onboarding, add a to-do item to the marketing team, and more using natural language, with authentication handled for you.

Basecamp logoBasecamp
Oauth2

Basecamp is a project management and team collaboration tool by 37signals. It helps teams organize tasks, share files, and communicate efficiently in one place.

330 Tools

Introduction

This guide walks you through connecting Basecamp to Google ADK using the Composio tool router. By the end, you'll have a working Basecamp agent that can create and complete to-dos, post to message boards, chat in Campfire, move cards across card tables, and add schedule entries through natural language commands.

This guide will help you understand how to give your Google ADK agent real control over a Basecamp account through Composio's Basecamp MCP server.

Before we dive in, let's take a quick look at the key ideas and tools involved.

For exact tool slugs and parameter tables, see the tool catalog in the Composio docs.

Also integrate Basecamp with

TL;DR

Here's what you'll learn:
  • Get a Basecamp account set up and connected to Composio
  • Install the Google ADK and Composio packages
  • Create a Composio Tool Router session for Basecamp
  • Build an agent that connects to Basecamp through MCP
  • Interact with Basecamp using natural language

What is Google ADK?

Google ADK (Agents Development Kit) is Google's framework for building AI agents powered by Gemini models. It provides tools for creating agents that can use external services through the Model Context Protocol.

Key features include:

  • Gemini Integration: Native support for Google's Gemini models
  • MCP Toolset: Built-in support for Model Context Protocol tools
  • Streamable HTTP: Connect to external services through streamable HTTP
  • CLI and Web UI: Run agents via command line or web interface

What is the Basecamp MCP server, and what's possible with it?

The Basecamp MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Basecamp account. It provides structured and secure access to your projects, to-dos, message boards, schedules, documents, chats, and card tables, so your agent can create projects, manage tasks, publish updates, organize cards, and retrieve project details on your behalf.

  • Project planning and updates: Have your agent create projects, review project details and participants, or update project names, descriptions, access settings, and schedules.
  • To-do management: Let the agent create, review, update, complete, and comment on to-dos, as well as review and update to-do lists.
  • Team communication: Direct your agent to publish message board posts, retrieve existing messages, review Campfire chats, and add comments to project work.
  • Card table organization: Instruct your agent to review card tables, create and update cards, or move cards between columns as work progresses.
  • Schedules and shared documents: Have your agent review project schedules and entries, retrieve vault documents, and create or update shared documents.

What is the Composio tool router, and how does it fit here?

What is Composio SDK?

Composio's Composio SDK helps agents find the right tools for a task at runtime. You can plug in multiple toolkits (like Gmail, HubSpot, and GitHub), and the agent will identify the relevant app and action to complete multi-step workflows. This can reduce token usage and improve the reliability of tool calls. Read more here: Getting started with Composio SDK

The tool router generates a secure MCP URL that your agents can access to perform actions.

How the Composio SDK works

The Composio SDK follows a three-phase workflow:

  1. Discovery: Searches for tools matching your task and returns relevant toolkits with their details.
  2. Authentication: Checks for active connections. If missing, creates an auth config and returns a connection URL via Auth Link.
  3. Execution: Executes the action using the authenticated connection.

Step-by-step Guide

Step by step09 STEPS
1

Prerequisites

Before starting, make sure you have:
  • A Google API key for Gemini models
  • A Composio account and API key
  • Python 3.9 or later installed
  • Basic familiarity with Python
2

Getting API Keys for Google and Composio

Google API Key
  • Go to Google AI Studio and create an API key.
  • Copy the key and keep it safe. You will put this in GOOGLE_API_KEY.
Composio API Key and User ID
  • Log in to the Composio dashboard.
  • Go to Settings → API Keys and copy your Composio API key. Use this for COMPOSIO_API_KEY.
  • Decide on a stable user identifier to scope sessions, often your email or a user ID. Use this for COMPOSIO_USER_ID.
3

Install dependencies

bash
pip install google-adk composio python-dotenv

Inside your virtual environment, install the required packages.

What's happening:

  • google-adk is Google's Agents Development Kit
  • composio connects your agent to Basecamp via MCP
  • python-dotenv loads environment variables
4

Set up ADK project

bash
adk create my_agent

Set up a new Google ADK project.

What's happening:

  • This creates an agent folder with a root agent file and .env file
5

Set environment variables

bash
GOOGLE_API_KEY=your-google-api-key
COMPOSIO_API_KEY=your-composio-api-key
COMPOSIO_USER_ID=your-user-id-or-email

Save all your credentials in the .env file.

What's happening:

  • GOOGLE_API_KEY authenticates with Google's Gemini models
  • COMPOSIO_API_KEY authenticates with Composio
  • COMPOSIO_USER_ID identifies the user for session management
6

Import modules and validate environment

python
import os
import warnings

from composio import Composio
from dotenv import load_dotenv
from google.adk.agents.llm_agent import Agent
from google.adk.tools.mcp_tool.mcp_session_manager import StreamableHTTPConnectionParams
from google.adk.tools.mcp_tool.mcp_toolset import McpToolset

load_dotenv()

warnings.filterwarnings("ignore", message=".*BaseAuthenticatedTool.*")

GOOGLE_API_KEY = os.getenv("GOOGLE_API_KEY")
COMPOSIO_API_KEY = os.getenv("COMPOSIO_API_KEY")
COMPOSIO_USER_ID = os.getenv("COMPOSIO_USER_ID")

if not GOOGLE_API_KEY:
    raise ValueError("GOOGLE_API_KEY is not set in the environment.")
if not COMPOSIO_API_KEY:
    raise ValueError("COMPOSIO_API_KEY is not set in the environment.")
if not COMPOSIO_USER_ID:
    raise ValueError("COMPOSIO_USER_ID is not set in the environment.")
What's happening:
  • os reads environment variables
  • Composio is the main Composio SDK client
  • GoogleProvider declares that you are using Google ADK as the agent runtime
  • Agent is the Google ADK LLM agent class
  • McpToolset lets the ADK agent call MCP tools over HTTP
7

Create Composio client and Tool Router session

python
composio_client = Composio(api_key=COMPOSIO_API_KEY)

composio_session = composio_client.create(
    user_id=COMPOSIO_USER_ID,
    toolkits=["basecamp"],
)

COMPOSIO_MCP_URL = composio_session.mcp.url,
print(f"Composio MCP URL: {COMPOSIO_MCP_URL}")
What's happening:
  • Authenticates to Composio with your API key
  • Declares Google ADK as the provider
  • Spins up a short-lived MCP endpoint for your user and selected toolkit
  • Stores the MCP HTTP URL for the ADK MCP integration
8

Set up the McpToolset and create the Agent

python
composio_toolset = McpToolset(
    connection_params=StreamableHTTPConnectionParams(
        url=COMPOSIO_MCP_URL,
        headers={"x-api-key": COMPOSIO_API_KEY}
    )
)

root_agent = Agent(
    model="gemini-2.5-flash",
    name="composio_agent",
    description="An agent that uses Composio tools to perform actions.",
    instruction=(
        "You are a helpful assistant connected to Composio. "
        "You have the following tools available: "
        "COMPOSIO_SEARCH_TOOLS, COMPOSIO_MULTI_EXECUTE_TOOL, "
        "COMPOSIO_MANAGE_CONNECTIONS, COMPOSIO_REMOTE_BASH_TOOL, COMPOSIO_REMOTE_WORKBENCH. "
        "Use these tools to help users with Basecamp operations."
    ),
    tools=[composio_toolset],
)

print("\nAgent setup complete. You can now run this agent directly ;)")
What's happening:
  • Connects the ADK agent to the Composio MCP endpoint through McpToolset
  • Uses Gemini as the model powering the agent
  • Lists exact tool names in instruction to reduce misnamed tool calls
9

Run the agent

bash
# Run in CLI mode
adk run my_agent

# Or run in web UI mode
adk web

Execute the agent from the project root. The web command opens a web portal where you can chat with the agent.

What's happening:

  • adk run runs the agent in CLI mode
  • adk web . opens a web UI for interactive testing

Complete Code

Here's the complete code to get you started with Basecamp and Google ADK:

python
import os
import warnings

from composio import Composio
from composio_google import GoogleProvider
from dotenv import load_dotenv
from google.adk.agents.llm_agent import Agent
from google.adk.tools.mcp_tool.mcp_session_manager import StreamableHTTPConnectionParams
from google.adk.tools.mcp_tool.mcp_toolset import McpToolset

load_dotenv()
warnings.filterwarnings("ignore", message=".*BaseAuthenticatedTool.*")

GOOGLE_API_KEY = os.getenv("GOOGLE_API_KEY")
COMPOSIO_API_KEY = os.getenv("COMPOSIO_API_KEY")
COMPOSIO_USER_ID = os.getenv("COMPOSIO_USER_ID")

if not GOOGLE_API_KEY:
    raise ValueError("GOOGLE_API_KEY is not set in the environment.")
if not COMPOSIO_API_KEY:
    raise ValueError("COMPOSIO_API_KEY is not set in the environment.")
if not COMPOSIO_USER_ID:
    raise ValueError("COMPOSIO_USER_ID is not set in the environment.")

composio_client = Composio(api_key=COMPOSIO_API_KEY, provider=GoogleProvider())

composio_session = composio_client.create(
    user_id=COMPOSIO_USER_ID,
    toolkits=["basecamp"],
)

COMPOSIO_MCP_URL = composio_session.mcp.url


composio_toolset = McpToolset(
    connection_params=StreamableHTTPConnectionParams(
        url=COMPOSIO_MCP_URL,
        headers={"x-api-key": COMPOSIO_API_KEY}
    )
)

root_agent = Agent(
    model="gemini-2.5-flash",
    name="composio_agent",
    description="An agent that uses Composio tools to perform actions.",
    instruction=(
        "You are a helpful assistant connected to Composio. "
        "You have the following tools available: "
        "COMPOSIO_SEARCH_TOOLS, COMPOSIO_MULTI_EXECUTE_TOOL, "
        "COMPOSIO_MANAGE_CONNECTIONS, COMPOSIO_REMOTE_BASH_TOOL, COMPOSIO_REMOTE_WORKBENCH. "
        "Use these tools to help users with Basecamp operations."
    ),  
    tools=[composio_toolset],
)

print("\nAgent setup complete. You can now run this agent directly ;)")

Conclusion

You've successfully integrated Basecamp with the Google ADK through Composio's MCP Tool Router. Your agent can now interact with Basecamp using natural language commands.

Key takeaways:

  • The Tool Router approach dynamically routes requests to the appropriate Basecamp tools
  • Environment variables keep your credentials secure and separate from code
  • Clear agent instructions reduce tool calling errors
  • The ADK web UI provides an interactive interface for testing and development

You can extend this setup by adding more toolkits to the toolkits array in your session configuration.

TOOLS

Supported Tools

Every Basecamp action and event your agent gets out of the box.

Archive Project

Archive a Basecamp project, removing it from the active project list.

Complete Subtask

Mark a Basecamp subtask as completed.

Complete To-Do

Tool to mark a to-do as completed in Basecamp.

Copy Recording

Start an asynchronous Basecamp recording or dock-tool copy.

Create Answer

Answer an automatic check-in question with rich text and a grouping date.

Create Bookmark

Bookmark a recording for the current user, returning the personal bookmark.

Create Boost

Post a short boost to a recording whose representation includes boosts_url.

Create Bubble Up

Resurface a recording in the current user's readings now or at a later date.

Create Campfire Upload

Upload a file directly to a Basecamp Campfire and create an upload line.

Create Card in Column

Tool to create a new card in a column of a Basecamp card table.

Create Step in Card

Tool to create a step within a card in a Basecamp card table.

Create Chatbot

Tool to create a new chatbot in a Basecamp Campfire chat.

Create Chatbot Line

Tool to post a message as a chatbot to a Basecamp Campfire.

Create Cloud File

Link an external file or document in a Basecamp project's vault or folder.

Create Document in Vault

Tool to create a new document in a Basecamp vault.

Create Embed

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

Create Event Boost

Publish a short note or emoji boost on a specific recording event.

Create External Link

Create an external link in a project's External links section.

Create Folder

Create a personal folder at the top of the current user's home screen.

Create Gauge Needle

Record a new project progress snapshot with a position, color, and HTML description.

Create Google Document

Link a Google Workspace document in a Basecamp project's vault or folder.

Create Hill Chart Progress Update

Save a hill chart progress update, optionally moving tracked to-do lists and adding an HTML note.

Create Ping

Open a private Basecamp Ping and automatically include the current user.

Create Project from Template

Tool to create a new project from a Basecamp template asynchronously.

Create Question

Create a scheduled automatic check-in question in a Basecamp questionnaire.

Create Recording Boost

Publish a short note or emoji boost on a recording.

Create Stream Ticket

Mint a short-lived ticket and exact WebSocket URL for live Basecamp events.

Create Subtask

Create a subtask under a Basecamp to-do or card, optionally with a due date and assignees.

Create Template Library Card Table

Create a named card table template in the account's template library.

Create Template Library Copy

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

Create Template Library Todolist

Create an empty to-do list template in the account's template library.

Create Templatification

Turn an existing project to-do list or card table into a library template.

Create Timesheet Entry

Log time spent on a recording and return the created timesheet entry.

Create To-Do List Group

Tool to create a new to-do group within a parent to-do list in Basecamp.

Create Todoset Todo

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

Create Tool

Add a tool to a project's dock, optionally choosing its title and client visibility.

Create Upload in Vault

Tool to create a new upload (file) in a Basecamp vault.

Create Upload Version

Replace an upload's file while keeping its ID, URL, comments and visibility.

Create a Vault

Tool to create a new vault (folder) within an existing parent vault in a Basecamp project.

Create Wormhole

Create a standing shortcut from a card table to a column on another card table.

Delete Bookmark

Remove the current user's personal bookmark from a recording.

Delete Boost

Delete a boost by its ID.

Delete Bubble Up

Remove the current user's bubble-up reminder from a recording.

Delete Card Table Column On-Hold Section

Tool to remove the on-hold section from a card table column.

Unpin Recording

Tool to unpin a recording (message) in a Basecamp project.

Delete Campfire Line

Tool to delete a Campfire line from a chat conversation.

Delete Chatbot

Tool to delete a chatbot from a Campfire chat.

Delete Folder

Delete a folder from the current user's home screen.

Delete Lineup Marker

Permanently delete an account-wide marker from the Lineup immediately.

Delete Message Type

Tool to delete a message type from a Basecamp project.

Delete Subtask

Delete a subtask from a to-do or card.

Delete Tool

Remove a tool from a Basecamp project's dock.

Delete Webhook

Tool to delete a webhook from a Basecamp project.

Delete Wormhole

Permanently delete a card table's wormhole shortcut to another card table.

Deprioritize Assignment

Remove a recording from the current user's Up Next assignments.

Destroy Gauge Needle

Destroy a project progress gauge needle by its ID.

Delete Timesheet Entry

Permanently delete a timesheet entry.

Disable Out of Office

Disable a person's out-of-office status in the connected Basecamp account.

Disable Project Clients

Disable client access on a Basecamp project.

Disable Tool

Hide a tool from its Basecamp project's dock without deleting its content.

Download File

Download file bytes from a complete provider-issued Basecamp URL.

Enable Out Of Office

Enable or replace a person's out-of-office date window.

Enable Project Clients

Enable clients on a standard project before adding client users.

Enable Tool

Show an existing tool at the end of its Basecamp project's dock.

Enroll Account Members

Enroll people on the Basecamp account and optionally grant project access.

Get Account

Retrieve the connected Basecamp account's name, owner, plan, limits and settings.

Get Answers By Person

List one person's answers to a specific automatic check-in question.

Get Assigned Todos

Retrieve a person's active, pending to-dos across projects.

Get Authorization

Retrieve the current token's identity, accessible accounts, scope and expiration.

Get Backlinks

List the most recent 20 recordings referencing a recording in rich text.

Get Bookmark

Check whether a recording is bookmarked by the current user.

Get Boost

Retrieve a single boost by ID, including its note, author and boosted recording.

Get Bubble Ups

List the current user's current and scheduled bubble-ups, 50 per page.

Get Cards from Card Table List

Tool to retrieve a paginated list of cards from a card table column.

Get Message Categories

Tool to retrieve all message types (categories) from a Basecamp project.

Get Campfire Chatbot Integrations

Tool to retrieve all chatbot integrations from a Campfire chat.

Get Campfire Lines

Retrieve Campfire lines from a specific chat in a Basecamp project.

Get Inbox Forwards

Retrieve active email forwards from a Basecamp project's inbox.

Get Messages from Message Board

Tool to retrieve a paginated list of active messages from a message board in a Basecamp project.

Get Question Answer by ID

Retrieve a specific automatic check-in question answer by ID from a Basecamp project, including its content, creator, comment count and comments URL.

Get Questionnaire

Tool to retrieve a specific questionnaire (automatic check-ins) from a Basecamp project.

Get Questions from Questionnaire

Tool to retrieve a paginated list of questions from a questionnaire in a Basecamp project.

Get Question by ID

Tool to retrieve a specific check-in question by ID from a Basecamp project.

Get Recording Events

Retrieve events for a specific recording in a Basecamp project to inspect its change history.

Get Schedule Entries

Retrieve schedule entries from a specific schedule in a Basecamp project, optionally filtering by archived or trashed status.

Get To-do List Groups

Retrieve a paginated list of groups from a to-do list in a Basecamp project, optionally filtering by status.

Get To-Dos from To-Do List

Tool to retrieve a paginated list of to-dos from a specific to-do list in a Basecamp project.

Get To-Do by ID

Tool to retrieve a specific to-do by ID from a Basecamp project.

Get Todoset To-Do Lists

Tool to retrieve a paginated list of to-do lists within a specific to-do set in a Basecamp project.

Get Upload by ID

Tool to retrieve a specific upload by ID from a Basecamp project vault.

Get Vault from Project

Retrieve a specific vault from a Basecamp project, including counts and collection URLs for its documents, uploads, and nested vaults when available.

Get Documents from Vault

Tool to retrieve a paginated list of active documents from a vault in a Basecamp project.

Get Uploads from Vault

Tool to retrieve a paginated list of active uploads from a vault in a Basecamp project.

Get Vaults from Parent Vault

Retrieve a page of vaults nested within a parent vault in a Basecamp project.

Get Project Webhooks

Retrieve a page of webhook configurations for a Basecamp project, including payload URLs, event types, and active status.

Get Calendar

Retrieve a Basecamp calendar's name, color and underlying schedule URL.

Get Campfire

Tool to retrieve a specific Campfire (chat room) by ID from a Basecamp project.

Get Campfire Line

Tool to retrieve a specific Campfire line by ID from a Basecamp project.

Get a specific card by ID

Tool to get a specific card by ID from a card table.

Get Card Step

Retrieve a card table step by ID, including assignments, due date and completion.

Get card table (Kanban board)

Tool to retrieve a card table (Kanban board) for a project.

Get Card Table Column

Tool to get a specific column from a card table within a Basecamp project.

Get Chatbot by ID

Tool to get a specific chatbot by ID from a Basecamp Campfire chat.

Get Chats

Retrieve one page of active Campfires visible to the current user from Basecamp.

Get Circles People

Retrieve a page of people on the Basecamp account who can be pinged.

Get Client Approval

Retrieve a client approval by ID, including its content and approval responses.

Get Client Correspondence

Retrieve one client correspondence by its identifier.

Get Client Reply

Retrieve one client reply to a correspondence or approval in a project.

Get Cloud File

Retrieve a cloud file's title, description, external link and service details.

Get Comment

Tool to retrieve a specific comment by ID from a Basecamp project.

Get Document by ID

Tool to get a specific document by ID from a Basecamp project bucket.

Get Embed

Retrieve a Basecamp embed using the signed global ID returned at creation.

Get Everything Checkins

List automatic check-in answers across all accessible projects, newest first.

Get Everything Comments

List comments across all accessible projects, newest first.

Get Everything Completed Cards

List completed cards across all accessible projects, grouped by project.

Get Everything Completed Todos

List completed to-dos across accessible projects, grouped by project.

Get Everything Files

List uploads, documents and rich-text attachments across accessible projects.

Get Everything Forwards

List inbox email forwards across all accessible projects, newest first.

Get Everything Messages

List messages across all accessible projects, newest first.

Get Everything No Due Date Cards

List open cards without a due date across accessible projects, grouped by project.

Get Everything No Due Date Todos

List open to-dos without a due date across accessible projects, grouped by project.

Get Everything Not Now Cards

List cards parked in Not now columns across all accessible projects.

Get Everything Open Cards

List incomplete cards in active columns across accessible Basecamp projects.

Get Everything Open Todos

List active, incomplete to-dos across accessible projects, grouped by project.

Get Everything Overdue Cards

List overdue cards across all accessible projects, oldest due date first.

Get Everything Overdue Todos

List all overdue to-dos across accessible projects, oldest due date first.

Get Everything Unassigned Cards

List open cards with no assignees across accessible projects, grouped by project.

Get Everything Unassigned Todos

List open to-dos with no assignees across accessible projects, grouped by project.

Get Filing

Read the current state of a Basecamp recording move or copy.

Get Folder

Retrieve a home-screen folder with its expanded project details.

Get Forward

Retrieve a forwarded email by ID, including content, sender, attachments and reply links.

Get Forward Reply

Retrieve one reply to a forwarded email, including content, attachments and sender details.

Get Gauge Needle

Retrieve one project progress update by its gauge needle ID.

Get Google Document

Retrieve a linked Google Workspace document by its Basecamp recording ID.

Get Hill Chart

Retrieve a to-do set's hill chart and tracked to-do list progress.

Get Hill Chart Progress Update

Retrieve one saved hill chart progress update, including its note and historical to-do list positions.

Get Inbox

Tool to get the inbox (email forwards) for a Basecamp project.

Get Message by ID

Tool to retrieve a specific message by ID from a Basecamp project message board.

Get Message Board

Tool to get the message board for a project.

Get Message Type by ID

Tool to retrieve a specific message type by ID from a Basecamp project.

Get My Assignments

Get the current user's active assignments grouped by priority.

Get My Completed Assignments

Get the current user's completed assignments in a single, unpaginated result.

Get My Due Assignments

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

Get My Note

Read the authenticated user's personal notebook note in Basecamp 5.

Get My Notifications

Get the current user's unread, recently read, and saved notifications.

Get My Preferences

Retrieve the connected user's time zone, first weekday and time display format.

Get My Profile

Tool to retrieve the current user's personal info including profile details, permissions, and settings.

Get Out Of Office

Get a person's out-of-office status and scheduled absence dates.

Get Overdue Todos

Get overdue to-dos across all projects, grouped by how late they are.

Get All People

Retrieve a page of people visible to the current user in the Basecamp account, including available contact information and permission fields.

Get Person by ID

Tool to retrieve the profile for a specific user by their ID.

Get Person Progress

Read a person's recent Basecamp activity timeline.

Get Ping

Retrieve a private Basecamp Ping the current user belongs to, including archived Pings.

Get Progress Report

Read one page of recent activity across all accessible Basecamp projects.

Get Project

Tool to retrieve a specific project by its ID with complete details.

Get Project Logo

Get a project's logo image URL without downloading the image.

Get Projects

Retrieve a page of projects visible to the current user, sorted by most recently created first.

Get Project by ID

Tool to retrieve a single project by its ID with full details including dock tools.

Get Projects People

Retrieve a page of active people assigned to a specific Basecamp project.

Get Projects Recordings

Retrieve a page of recordings of a specified type across Basecamp projects, with optional project and status filters and sorting.

Get Project Timeline

Read one page of recent activity in a Basecamp project.

Get Project Timesheet

List one page of time entries across a project and its recordings.

Get Project Wallpaper

Get a project's wallpaper image URL without downloading the image.

Get Question Reminders

Get one page of pending automatic check-in reminders for the current user.

Get Recording

Retrieve a Basecamp recording by ID without needing to know its type.

Get Recording Timesheet

List one page of time entries logged on a specific recording.

Get Timesheet Report

Tool to retrieve all timesheet entries across the Basecamp account within a given timeframe.

Get Schedule for Project

Tool to retrieve schedule details for a specific project.

Get Schedule Entry

Tool to get a specific schedule entry by ID from a Basecamp project.

Get Schedule Entry Occurrence

Get one occurrence of a recurring schedule entry by entry ID and date.

Get Search Metadata

Get the account's available search filter options and default labels.

Get Subscription

Tool to get subscription information for a recording.

Get Subtask

Get a Basecamp subtask by ID, including its parent, assignees and completion details.

Get Template Library Card Tables

Retrieve the account's card table templates in title order.

Get Template Library Copy

Check the progress and result of copying a template into a project.

Get Template Library To-do Lists

Retrieve the account's active to-do list templates in title order.

Get Templates

Tool to retrieve a paginated list of active templates visible to the current user, sorted by most recently created first.

Get Template by ID

Tool to retrieve a single template by its ID with full details including dock tools.

Get Project Construction Status

Tool to retrieve the status of a project construction from a template.

Get Templatification

Check progress of turning a to-do list or card table into a template.

Get Timesheet Entry

Retrieve a single timesheet entry by its ID.

Get To-Do by ID

Tool to retrieve a specific to-do by ID from a Basecamp project.

Get To-Do List

Tool to retrieve a specific to-do list from a Basecamp project by its ID.

Get To-Do Set

Tool to retrieve a specific to-do set from a Basecamp project.

Get Tool

Retrieve a project's dock tool by its recording ID.

Get Upcoming Schedule

Get upcoming schedule entries, recurring occurrences and dated assignments.

Get Upload

Tool to get a specific upload by ID from a Basecamp project.

Get Webhook by ID

Tool to retrieve a specific webhook by ID from a Basecamp project.

Join Project

Join the connected person's project when its admission policy permits it.

List Answers

List a check-in question's answers, optionally filtered by day or author.

List Assignable People

List people who can be assigned to-dos in the connected Basecamp account.

List Campfire Uploads

List files uploaded to a Basecamp Campfire, newest first by default.

List Chatbots

Tool to get all chatbots for a chat/campfire.

List Client Approvals

List a project's client approvals with subjects, due dates and approval status.

List Client Correspondences

List a project's client correspondences, with optional sorting and pagination.

List Client Replies

List replies to a client correspondence or client approval in a project.

List Comments

Retrieve a page of active comments on a recording in a Basecamp project, including content, creators, and metadata.

List Event Boosts

List one page of active boosts on a specific event within a recording.

List Folders

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

List Forward Replies

List one page of replies to a forwarded email, including authors, HTML content and attachments.

List Forwards

List active forwarded emails in a project's inbox, including content and reply links.

List Gauge Needles

List a project's progress updates, newest first.

List Gauges

List project progress gauges across projects accessible to the connected user.

List Hill Chart Versions

List a to-do set's hill chart progress updates, newest first.

List Lineup Markers

List all account-wide date markers displayed in the Basecamp Lineup.

List Message Types

Tool to retrieve all message types in a Basecamp project.

List My Bookmarks

List the current user's personal bookmarks, most recently bookmarked first.

List My Drafts

List the current user's unpublished drafts across active Basecamp projects.

List Personal Readings

List the user's unread, recent, current, and scheduled notifications.

List Pings

List active Basecamp Pings the current user belongs to, newest updates first.

List Project People

List active people with access to a specific Basecamp project.

List Question Answerers

List people who have answered a Basecamp automatic check-in question.

List Recent Projects

List the current user's most recently visited active Basecamp projects.

List Recording Boosts

List one page of active boosts on a recording, including their notes and authors.

List Subtasks

List a Basecamp to-do or card's subtasks in position order.

List To-Do Lists in To-Do Set

List a page of to-do lists in a Basecamp project's to-do set, optionally filtering by archived or trashed status.

List Uploads from Vault

List active uploads in a Basecamp project vault, returning one page at a time with pagination information when available.

List Upload Versions

List an upload's version events, newest first, with version-specific file URLs.

Mark As Read

Mark specified notifications as read for the current user.

Move Card to Column

Tool to move a card to a different column within a Basecamp card table.

Reorder Card Table Column

Tool to reorder columns within a Basecamp card table.

Move Recording

Start an asynchronous Basecamp recording or dock-tool move.

Move Recording to Vault

Move a document, upload, or vault into another vault in the same project.

Pause Question

Pause an automatic check-in question to stop sending its reminders.

Pin Message

Tool to pin a message to the top of the message board.

Poll Events

Read one page of the account's resumable event notification feed.

Poll Inbox

Read one page of addressed inbox deliveries for the authenticated agent.

Upload File Attachment

Tool to upload a file to Basecamp system.

Move Card to Column

Tool to move a card to a different column within a Basecamp card table.

Reposition Step in Card

Tool to reposition a step within a card in a Basecamp card table.

Create Card Table Column

Tool to create a column within a Basecamp card table.

Create On-Hold Section in Column

Tool to create an on-hold section in a card table column.

Create Message Category

Tool to create a new message type (category) in a Basecamp project.

Create Campfire Line

Tool to create a line in a Basecamp Campfire chat.

Create Message on Message Board

Tool to publish a message to a Basecamp message board within a project.

Create Comment on Recording

Tool to publish a comment on a recording within a Basecamp project.

Pin Recording

Tool to pin a recording (message) in a Basecamp project.

Subscribe to Recording

Tool to subscribe the current user to a recording for notifications.

Create Schedule Entry

Tool to create a schedule entry in a Basecamp schedule within a project.

Create Comment on To-Do List

Tool to add a comment to a to-do list in a Basecamp project.

Create To-Do in To-Do List

Tool to create a to-do in a Basecamp to-do list within a project.

Comment on To-Do

Tool to add a comment to a to-do in a Basecamp project.

Create To-Do List in To-Do Set

Tool to create a new to-do list in a Basecamp to-do set within a project.

Create Webhook

Tool to create a new webhook subscription for a Basecamp project.

Create Campfire Line via Chatbot

Create a line in a Basecamp Campfire chat using a chatbot key and the connected Basecamp account.

Create Lineup Marker

Tool to create an account-wide marker that shows up in the Lineup.

Create New Project

Tool to create a new project in Basecamp with a name and optional description.

Create New Template

Tool to create a new template in Basecamp with a name and optional description.

Prioritize Assignment

Add a recording to the current user's Up Next prioritized assignments.

Update Card Table Column Color

Tool to update a card table column's visual color designation in a Basecamp project.

Update Card Table Step

Tool to update an existing card table step in Basecamp.

Mark Step Completion Status

Tool to mark a card table step as completed or uncompleted in Basecamp.

Update Message Category

Update an existing message type (category) in a Basecamp project, supplying both its name and icon.

Update Chatbot Integration

Update an existing chatbot integration in a Basecamp Campfire chat.

Update Comment

Tool to update comment content in a Basecamp project.

Update Document in Bucket

Tool to update an existing document in a Basecamp project bucket.

Update Message

Tool to update a message's subject, content, or category in a Basecamp project.

Update Recording Client Visibility

Tool to update client visibility for a recording in Basecamp.

Unarchive Recording

Tool to unarchive a recording in a Basecamp project by marking it as active.

Archive Recording

Tool to mark a recording as archived in a Basecamp project.

Trash Recording

Tool to mark a recording as trashed in a Basecamp project.

Update Recording Subscription

Tool to update recording subscriptions by adding or removing subscribers.

Update Schedule Entry

Tool to update an existing schedule entry in a Basecamp schedule.

Update Schedule Configuration

Tool to update a schedule configuration in a Basecamp project.

Reposition To-Do List Group

Tool to reposition a to-do list group within its parent to-do list in a Basecamp project.

Update To-Do in Bucket

Tool to update an existing to-do in a Basecamp project.

Reposition To-Do

Tool to change the position of a to-do within its list in a Basecamp project.

Update Upload in Bucket

Tool to update an existing upload in a Basecamp project bucket.

Update Vault Title

Tool to update a vault's title in a Basecamp project.

Update Webhook

Tool to update an existing webhook in a Basecamp project.

Update Project

Tool to update an existing project's name, description, access policy, or schedule in Basecamp.

Grant or Revoke Project Access

Tool to grant or revoke project access for users in Basecamp.

Update Template

Tool to update a template's name and description in Basecamp.

Record Project Visit

Record the current user's visit to a project, moving it to the front of their recent projects.

Remove Account Logo

Remove the connected Basecamp account's logo.

Remove Project Logo

Remove a project's logo; requires permission to edit the project.

Remove Project Wallpaper

Remove a project's wallpaper; requires permission to edit the project.

Reorder Up Next

Move an already-prioritized assignment to a new position in your Up Next list.

Reposition Card Step

Tool to change the position of a step within a card.

Reposition Subtask

Move a subtask to a new position among its siblings.

Reposition To-do List

Move a to-do list to a new position within its current to-do set.

Reposition Tool

Move a docked tool to a new position in its project's dock.

Resolve External Link

Resolve an external link's outside URL without visiting it.

Resume Question

Resume a paused automatic check-in question so it sends reminders again.

Search Basecamp

Search accessible Basecamp recordings by text, type, and result order.

Spotlight Recording

Spotlight a recording on the home page of its own project or template.

Subscribe To Card Column

Start watching a card table column for changes as the connected user.

Toggle Gauge

Enable or disable a project's progress gauge.

Trash Project

Tool to mark a Basecamp project as trashed.

Trash Template

Tool to mark a template as trashed in Basecamp.

Unarchive Project

Restore an archived or trashed Basecamp project to active status.

Uncomplete Subtask

Reopen a completed Basecamp subtask by marking it as uncompleted.

Uncomplete To-Do

Tool to mark a to-do as uncompleted in Basecamp.

Unpin Message

Tool to unpin a message from the message board.

Unspotlight Recording

Remove a recording's spotlight from its project or template home page.

Unsubscribe Current User from Recording

Tool to unsubscribe the current user from a recording.

Stop Watching Card Table Column

Tool to stop watching a card table column.

Update Account Logo

Upload or replace the account logo.

Update Account Name

Rename the connected Basecamp account and return its updated account details.

Update Answer

Update an existing automatic check-in answer's text and grouping date.

Update Boost

Replace a boost's short note or emoji and return the updated boost.

Update Calendar

Change a Basecamp calendar's display color and return the updated calendar.

Update Campfire Line

Edit a Campfire line created by the connected user.

Update Card

Tool to update a card's details in a Basecamp card table.

Update Card Table Column

Tool to update a card table column's properties in a Basecamp project.

Update Cloud File

Replace a cloud file's external link, service, title and description.

Update Document

Tool to update an existing document's title or content in a Basecamp project.

Update Folder

Rename a folder on the authenticated user's home screen.

Update Gauge Needle

Update the HTML description of an existing Basecamp gauge needle.

Update Google Document

Replace a Google document's link, kind, title and HTML description.

Update Hill Chart Settings

Start or stop tracking to-do lists on a to-do set's hill chart.

Update Lineup Marker

Change the name and/or date of an account-wide Basecamp Lineup marker.

Update My Note

Replace the authenticated user's personal notebook note with HTML content.

Update My Preferences

Update the connected user's time zone, first weekday or time display format.

Update My Profile

Update the connected user's personal profile; returns no content on success.

Update Project Client Access

Grant or revoke project access for clients, or invite new clients by email.

Update Project Logo

Upload or replace an existing project's logo using a direct multipart file upload.

Update Project Wallpaper

Upload or replace a project's wallpaper using a direct multipart image upload.

Update Question

Update an automatic check-in question's title, schedule, or both.

Update Question Notification Settings

Change your participation and answer notifications for a check-in question.

Update Subtask

Change a Basecamp subtask's title, due date or assignees.

Update Timesheet Entry

Update a timesheet entry and return its current details.

Update To-Do

Tool to update a to-do's content, assignees, or due date in a Basecamp project.

Update To-Do List

Tool to update a to-do list's name or description in a Basecamp project.

Update Tool

Rename an existing tool in a project's dock and return its updated details.

Update Vault Title

Tool to update a vault's title in a Basecamp project.

Update Vault View Preference

Set the current user's grid or list view for one vault in Docs & Files.

Update Wormhole

Change a card table wormhole's destination to another accessible column.

Validate Credential

Validates Basecamp API credentials by verifying the OAuth token and retrieving authorization details.

Watch Card Table Column

Tool to start watching a card table column in a Basecamp project.

FAQ

Frequently asked questions

Start with Basecamp.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Basecamp tool your agent needs.Free to start.

Start building