# Basecamp MCP for AI Agents MCP

> Basecamp MCP connects your AI agent directly to your entire Basecamp workspace. Stop clicking through tabs just to get a project update. Use natural conversation to list projects, track pending tasks, read message boards, and pull recent chat logs for an instant overview of team activity.

## Overview
- **Category:** communication-messaging
- **Price:** Free
- **Tags:** task-tracking, team-communication, async-work, project-organization, todo-lists

## Description

Don't open the Basecamp web interface just to check on three different projects. Connect this MCP and let your AI agent do the heavy lifting. You can ask your agent questions like, 'What are Sarah's overdue tasks in the Accounting project?' or 'Summarize the last five chat lines for the Website Redesign.' Your agent reads all that data—the messages, the to-dos, the active projects, and even the people directory—and gives you a clean summary right where you work. It keeps your team’s activity centralized and actionable without forcing you into complex web views. You manage project health, task backlogs, and communication flows entirely through natural conversation, making sure nothing slips through the cracks.

## Tools

### list_projects
Retrieves a list of all Basecamp projects that are currently active.

### get_project
Fetches detailed information for one specific Basecamp project using its unique identifier.

### list_todolists
Lists all to-do sets and the specific todolists contained within them.

### list_todos
Retrieves a list of individual todos that are pending under a specified todolist.

### list_messages
Pulls the latest messages posted on a project's main communication board.

### list_campfire_lines
Reads recent, interactive chat lines from any given project's Campfire module.

### list_people
Enumerates all team members and organizational profiles available in the Basecamp account.

## Prompt Examples

**Prompt:** 
```
What's the latest activity for the 'Mobile MVP 2026' project?
```

**Response:** 
```
**Project: Mobile MVP 2026**

*   **Latest Message Board Post:** David posted about updating the API endpoints (3 comments).
*   **Recent Chat Logs (Campfire):** Anna mentioned she needs final sign-off on the wireframes by EOD today. John confirmed he'll get it to her.
*   **Pending Tasks:** Two items are open: 1. Finalize payment gateway setup (Due: Friday). 2. Review user flow documentation (Assigned: You).
```

**Prompt:** 
```
List all pending todos for the 'Accounting Integration' todolist.
```

**Response:** 
```
**⚠️ Action Required:**

You have three unresolved tasks under Accounting Integration:

*   **Task 1:** Review Q3 budget reports. (Due: Tomorrow)
*   **Task 2:** Schedule legal review of vendor contracts. (Assigned to: Sarah M.)
*   **Task 3:** Update system compliance checklist. (Last updated: 2 weeks ago). Please prioritize this one.
```

**Prompt:** 
```
Can you summarize the key projects our team is working on?
```

**Response:** 
```
I pulled your Basecamp hierarchy and found three primary explicit projects:

1.  **Mobile MVP 2026:** Focused on core features, high activity in Campfire.
2.  **Accounting Integration:** Currently focused on compliance and task resolution (3 pending todos).
3.  **HQ General Ops:** Contains the general team directory and major announcements.
```

## Capabilities

### List and retrieve team project details
Get a list of all current projects or fetch deep details on one specific Basecamp project.

### Manage pending to-do items
List todosets, examine explicit todolists, or check individual tasks awaiting resolution across your team's workstreams.

### Review communication history and people directory
Access the latest message board posts, retrieve chat lines from Campfire logs, and list all organizational profiles in Basecamp.

## Use Cases

### Need to summarize the status of a large client account
You ask your agent, 'Give me the overall health for Client X.' It automatically runs through list_projects and then aggregates messages from list_messages across all associated projects, giving you one cohesive report.

### Checking on development blockers during a sprint
A developer asks their agent to check 'Launch Day' todos. The agent executes list_todos and reports back the four incomplete items, including who they were assigned to, allowing them to start fixing code immediately.

### Onboarding a new team member
A manager needs an overview of the team structure. Asking for the people directory (list_people) instantly provides profiles and roles, eliminating manual searches in the organization chart.

## Benefits

- Get immediate daily digests: Ask your agent to summarize task backlogs and chat chatter from multiple projects simultaneously. You don't have to open five different tabs.
- Contextual task searching: While you’re coding, ask your agent to search for unresolved bugs or pending todos directly within your IDE, pulling data from the todolists.
- Centralized status updates: Instead of navigating through complex project UIs, let your AI client fetch updates and summarize entire backlogs with a single prompt.
- Full team visibility: Use the people directory mapping to get an overview of who's assigned what, and track accurate author histories across all projects.
- Historical context access: Retrieve recent chat lines from Campfire logs or read old message board announcements without digging deep into archives.

## How It Works

The bottom line is: you tell the agent what information you need, and it handles connecting to Basecamp and synthesizing the answer for you.

1. Subscribe to this MCP on Vinkius.
2. Enter your specific Basecamp Access Token and Account ID into your AI client's settings.
3. Ask your agent a question about project status, tasks, or chat history in plain language.

## Frequently Asked Questions

**How does Basecamp MCP help me track my project status?**
Basecamp MCP lets your AI agent read all of your projects' activity—messages, tasks, and chats—in one go. You ask a question like 'What is the status?' and it gathers everything needed to give you a single, comprehensive answer.

**I don't want to use my AI agent for every task. Is Basecamp MCP reliable?**
Yes. The connection reads directly from your established Basecamp account data, ensuring the information is accurate and current. It just changes *how* you access it—from clicking tabs to asking questions.

**Can I use this MCP if my team uses multiple projects?**
Absolutely. You can ask your agent to compare or summarize status across several different projects in one prompt, saving massive amounts of manual cross-referencing time.

**What kind of information about people can I get with Basecamp MCP?**
You'll get a complete picture of your team. It lists all users and their profiles, allowing you to see who is assigned what task or who was involved in key project announcements.

**Does this tool help me find old conversations I missed?**
Yes. By listing campfire lines and message board posts, the MCP makes it easy to retrieve recent chat history from a project's core communication area without having to scroll through years of archives.