# Basecamp MCP for AI Agents AI Agent Connect

> Basecamp MCP lets you manage project boards, to-do lists, and team communication directly from your AI client. It handles the heavy lifting of updating tasks, reading board messages, and keeping your team aligned without you having to click through multiple tabs.

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

## Description

This Basecamp MCP lets you bring your project management data directly into your chat. You can create new projects, build out to-do lists, and assign tasks to specific team members without ever leaving your conversation. It handles the metadata, too, making sure your projects have the right message boards and schedules set up from the start. If you want to stop the constant status update pings, you can use this to query project states and to-do progress instantly. It is hosted on Vinkius, so you can plug it in and start managing your team's work through natural language. Instead of hunting for a specific message or checking a list to see who is done, your agent does the digging for you. You get a way to keep your team's progress visible while you stay focused on high-level work, letting your agent handle the data entry and status tracking.

## Tools

### complete_todo
Mark a task as finished so it stays in the list but shows as done. Use this to clear your daily queue.

### create_comment
Add rich text feedback to any recording or to-do item. This notifies all subscribers of your update.

### create_project
Initialize a new project with a message board and schedule. This sets up the full dock for your new work.

### create_todo
Generate a new task with a title, description, and due date. Use this to build out your team's next steps.

### get_message
Pull the full details of a specific message. This helps you see the complete context of a board post.

### get_my_profile
Check your current connection and account permissions. Use this to verify that your agent has the right access.

### get_person
Look up the specific details of a team member or assignee. This is useful for finding contact info or roles.

### get_project
Retrieve all metadata and dock IDs for a specific project. Use this to find the right IDs for your to-do lists.

### get_todo
Fetch the full details of a single to-do item. This gives you all the context for a specific task.

### list_messages
See all posts on a project message board at once. Use this to get a quick summary of the latest team talk.

### list_people
Get a list of everyone in your Basecamp account. This helps you find the right IDs for assigning tasks.

### list_project_people
See who is assigned to a specific project and their roles. This helps you check team composition quickly.

### list_projects
View all active, archived, or trashed projects. Use this to get a high level view of your entire portfolio.

### list_todos
See all pending or completed items in a specific to-do list. This helps you track progress on a single goal.

### uncomplete_todo
Reopen a finished task that needs more work. Use this when a completed item needs to be reworked.

### update_project
Change the name or description of an existing project. Use this to keep your project metadata current.

### update_todo
Modify the details of an existing task without changing its status. Use this to tweak descriptions or dates.

## Prompt Examples

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

**Response:** 
```
I've checked the message board for the **Website Redesign** project. Here are the latest updates:

* **Design Approval:** Lisa confirmed the new homepage layout.
* **Content Status:** Marcus noted that the copy for the 'About Us' section is 80% complete.
* **Blocker:** Engineering is waiting on the high-res assets from the marketing team.

Would you like me to read the full thread for any of these?
```

**Prompt:** 
```
Create a to-do for the dev team to 'Fix login bug' by Friday.
```

**Response:** 
```
Done! I've created the following task:

* **Task:** Fix login bug
* **Assignee:** Dev Team
* **Due Date:** Friday, May 24, 2024
* **Status:** Pending

I've added it to your active to-do list. Do you want me to add a detailed description for the devs?
```

**Prompt:** 
```
Who is currently assigned to the 'Marketing Push' project?
```

**Response:** 
```
Here is the team currently assigned to the **Marketing Push** project:

| Name | Role |
| :--- | :--- |
| Sarah M. | Lead Designer |
| James T. | Content Strategist |
| Marcus R. | Web Developer |

I can also check the status of their specific tasks if you'd like.
```

## Capabilities

### Create new projects
Initialize a new project with a message board, to-do set, and schedule.

### Build to-do lists
Create and manage to-do items with descriptions, assignees, and due dates.

### Assign tasks
Assign specific tasks to team members using their unique IDs.

### Read message boards
Pull and summarize the latest updates from your project message boards.

### Add project comments
Add rich text comments to any to-do, message, or document.

### Verify account access
Check your authenticated profile and permissions to confirm connectivity.

## Use Cases

### New Project Kickoff
A manager asks the agent to create a project and a to-do list for a new client. The agent uses create_project and create_todo to set everything up in seconds.

### Status Check
A lead asks 'What's the status of the marketing site?' and the agent reads the latest board messages using list_messages to give a summary.

### Task Assignment
An admin asks the agent to assign 'Review Mockups' to Sarah with a due date of next Friday. The agent finds Sarah's ID via list_people and creates the task.

### Feedback Loop
A designer asks the agent to add a comment to a specific task to flag a design blocker. The agent uses create_comment to notify the whole team.

## Benefits

- Stop manual data entry by using create_todo to build lists instantly.
- Keep everyone in the loop with create_comment for real-time feedback.
- Save time on project setup by using create_project to initialize docks.
- Get a bird's eye view of progress with list_projects and list_todos.
- Find the right person quickly using list_people to identify assignee IDs.
- Stay updated without clicking by using list_messages to see board posts.

## How It Works

The bottom line is you get a hands-free way to manage project data without leaving your chat interface.

1. Subscribe to the Basecamp MCP on Vinkius.
2. Provide your Basecamp OAuth access token and account ID.
3. Ask your agent to create tasks, read boards, or update projects.

## Frequently Asked Questions

**Can I use the Basecamp MCP to manage my team's tasks?**
Yes, you can create, update, and complete tasks through your AI agent. This means you can build out to-do lists and assign them to specific team members without leaving your chat interface.

**Does the Basecamp MCP let me see my project messages?**
Yes, it can list and read messages from your project boards. You can ask your agent to summarize the latest updates or pull specific details from a conversation.

**Can I use this to see who's on my team?**
Yes, the Connector can list everyone in your Basecamp account. This is helpful for finding the right people to assign tasks to or checking team composition.

**How do I update a project name with the Basecamp MCP?**
You can simply ask your agent to change the project name. It will update the metadata in Basecamp for you instantly, keeping your workspace organized.

**Can I add comments to my project recordings?**
Yes, you can add comments to any recording, including to-dos and documents. Your agent can even include rich text to provide detailed feedback.

**Is the Basecamp MCP good for remote teams?**
It is excellent for remote teams because it centralizes information. You can query project states and to-do progress directly from your agent to keep everyone aligned.

**Can I see my past projects with the Basecamp MCP?**
Yes, the Connector can list your active, archived, and trashed projects. This gives you a full view of your historical and current work.

**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.