# Basecamp MCP for AI Agents AI Agent Connect

> Basecamp MCP lets you pull your project data directly into your AI workspace. If you're tired of switching tabs to check on a deadline or hunting through message boards for an update, this Connector handles the heavy lifting. You can ask your agent to summarize a project's status, find specific tasks, or see what your team is chatting about. It treats your Basecamp account like a live database. By connecting this through Vinkius, you get a way to keep your work centralized without the friction of a web interface.

## Overview
- **Category:** collaboration
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_Ilj7D4Oxk6AYPq0inE6epz4atduPGSMvdtmUmxJq/ai-agent-connect
- **Tags:** task-tracking, team-communication, file-sharing, project-scheduling, to-do-lists, message-boards

## Description

Basecamp MCP lets you pull your project data directly into your AI workspace. If you're tired of switching tabs to check on a deadline or hunting through message boards for an update, this Connector handles the heavy lifting. You can ask your agent to summarize a project's status, find specific tasks, or see what your team is chatting about. It treats your Basecamp account like a live database that your agent can query at any time. By connecting this through Vinkius, you get a way to keep your work centralized without the friction of a web interface. It's about getting the facts you need exactly when you need them, whether you're writing code, drafting a report, or planning a sprint.

## Tools

### create_comment
). The recording_id is the unique numeric ID of the item you want to comment on. The content must be provided as rich text (HTML). All subscribers to the recording will be notified of the new comment.

Add a comment to any Basecamp recording

### create_todo
Requires the todolist_id and the content (title) of the to-do. Optionally include a rich text description, assignee IDs (array of person IDs), and a due date in YYYY-MM-DD format. The to-do will be created as pending (not completed).

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

### get_message
Get full details of a specific message

### get_my_profile
Use this to verify connectivity or identify the current operator.

Get the authenticated Basecamp user profile

### get_person
Use this to look up details about a team member or assignee.

Get full details of a specific person

### get_todo
Get full details of a specific to-do item

### list_project_people
Returns names, emails, and roles. Useful for checking team composition before assigning tasks.

List all people assigned to a specific project

### uncomplete_todo
Use this when a previously completed task needs to be reopened or reworked.

Mark a completed to-do item as pending again

### update_project
At least one of name or description must be provided. Returns the updated project details including the full dock listing.

Update an existing project in Basecamp

### update_todo
At least one field must be provided. Does not affect completion status — use the complete_todo or uncomplete_todo tools for that.

Update an existing to-do item in Basecamp

### complete_todo
This is separate from archiving or trashing — a completed to-do remains active but is marked as done. Use uncomplete_todo to reverse this action.

Mark a to-do item as completed

### create_project
The project will be initialized with default tools (message board, to-do set, schedule, etc.) enabled via its dock. Returns the newly created project with its numeric ID and dock tool IDs.

Create a new project in Basecamp

### list_projects
Shows all active projects in your Basecamp account. This helps you get a high level view of your work.

### get_project
Pulls the details for a specific project. You can use it to see who is assigned to what.

### list_todos
Fetches every individual task within a specific todo list. Use it to see what still needs to get done.

### list_messages
Pulls the latest posts from a project's message board. This keeps you updated on team announcements.

### list_people
Lists everyone in your organization and their profiles. This provides a quick way to see who is on the team.

## Prompt Examples

**Prompt:** 
```
What's the latest on the Website Redesign project?
```

**Response:** 
```
### Website Redesign Status
I've checked the message boards and the latest todos. Here is the current status:

**Recent Updates:**
* **Final CSS Delivery** - Anna M. (3 comments)
* **DNS Blockers** - David (0 comments)

**Pending Tasks:**
* Deploy Vinkius Cluster
* Setup Stripe Billing (Assigned: Sarah)
* Finalize README

Would you like me to pull the latest campfire chat lines for more context?
```

**Prompt:** 
```
List all pending todos on the Launch Day todolist.
```

**Response:** 
```
I've pulled the pending items from the **Launch Day** todo list. You have 4 unfinished tasks:

| Task | Status | Assignee |
| :--- | :--- | :--- |
| Deploy Vinkius Cluster | Pending | Unassigned |
| Setup Stripe Billing | Pending | Sarah |
| Finalize README | Pending | Unassigned |
| [Task 4] | Pending | Unassigned |

All items are currently active and awaiting resolution.
```

**Prompt:** 
```
Who is on the team?
```

**Response:** 
```
I've pulled the people directory for your Basecamp account. Here are the team members:

* **Anna M.** - Project Lead
* **David** - Engineering
* **Sarah** - Billing & Ops
* **[Other Team Members...]**

Would you like to see the specific project assignments for any of these people?
```

## Capabilities

### Pull active project lists
Get a high level view of all your current projects in one go.

### Fetch project details
Grab specific information for a single project to see who is doing what.

### Scan todo lists
Check specific lists to see what tasks are still pending.

### Read message boards
Pull the latest announcements and team updates from project boards.

### Grab campfire chat lines
Retrieve the most recent interactive chat lines from your project modules.

### Get a full team directory
See every person in your organization and their profiles in one list.

## Use Cases

### Checking status across ten different projects
A project manager is tired of opening every project tab to see what is done. They ask their agent to summarize the status of all active projects. The agent uses list_projects and list_todos to give a single summary.

### Finding bug reports while coding
A developer wants to see the latest message board posts without leaving their IDE. They ask their agent to check the 'Bug Reports' board. The agent uses list_messages to pull the latest updates.

### Catching up on team chat
A team lead missed the morning meeting and needs to see what was discussed. They ask their agent to pull the last few lines from the campfire. The agent uses list_campfire_lines to provide a quick summary.

### Monitoring client assignee distribution
An agency owner needs to see how many people are working on a specific client. They ask their agent to list the team. The agent uses list_people to show the directory and project mapping.

## Benefits

- Get a clear view of all active projects using list_projects instead of clicking through folders.
- Find specific tasks faster by scanning todos with list_todos and list_todolists.
- Stay updated on team news by pulling message board posts with list_messages.
- Catch up on quick chats instantly using list_campfire_lines to see what is happening right now.
- Know exactly who is on the team by pulling the directory with list_people.

## How It Works

The bottom line is you get instant access to your project data without leaving your primary workspace.

1. Subscribe to the Basecamp MCP on the Vinkius marketplace.
2. Enter your Basecamp Access Token and Account ID in the configuration.
3. Ask your AI client to summarize your project status or find specific tasks.

## Frequently Asked Questions

**Can I use the Basecamp MCP to see my tasks?**
Yes. The Connector allows your AI agent to pull your todo lists and individual tasks directly into your chat or IDE. You can ask for specific lists or a summary of what is pending.

**How does Basecamp MCP help with team communication?**
It gives your agent the ability to read message boards and campfire logs. You can ask for summaries of recent announcements or catch up on the latest team conversations.

**Does Basecamp MCP work with Cursor?**
Yes. You can connect this Connector to Cursor, Claude, or any other compatible AI client to bring your Basecamp data into your coding environment.

**Can I get a summary of my message board?**
Absolutely. Your agent can scan the message board for a specific project and provide a summarized list of the latest posts and discussions.

**How do I connect Basecamp MCP to my agent?**
You just need to subscribe to the Connector on Vinkius and provide your Basecamp Access Token and Account ID. From there, your AI client can start querying your data.

**Can my AI agent summarize discussions from Basecamp Campfires?**
Yes. Command the agent to 'List recent campfire lines from project X'. It retrieves the chat log arrays, allowing the LLM natively to digest confusing thread debates into a pristine bullet-point summary.

**How does the agent handle nested 'Todoset' boundaries?**
Basecamp uses specific bounded models. The agent automatically runs sequential tools: finding the project, identifying the explicit Todoset ID, listing todolists inside it, and ultimately grabbing the real atomic 'Todos'. It navigates the structure smoothly.

**Does it track who wrote a specific task or message board post?**
Absolutely. Alongside content, it extracts explicit metadata profiling authors using the 'list_people' bindings. This perfectly exposes actionable context on exactly who dropped a critical file or task update.

**Can I create a to-do and assign it to a team member directly via the AI agent?**
Yes! Use the `create_todo` tool with the to-do list ID, content, and the assignee person IDs. You can also set a due date. The to-do will be created and assigned instantly in Basecamp.

**How do I find the to-do list ID I need to create tasks in?**
First, use `get_project` to retrieve the project details — the dock will contain the `todoset` ID. Then use the Basecamp UI or the to-do set to find your specific to-do list IDs within that project.

**Can I mark a to-do as completed and later reopen it if needed?**
Absolutely. Use the `complete_todo` tool to mark a to-do as done, and `uncomplete_todo` to reopen it. This only affects the completion status — the to-do remains active and visible in the project.