Basecamp MCP. Manage tasks and projects without leaving your chat.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
Basecamp MCP Server connects your AI agent directly to your Basecamp workspace. Manage projects, track tasks, and communicate with your team—all from natural conversation.
You can list all projects, create new to-do items, assign tasks to specific people, and read message boards without opening the Basecamp UI.
It keeps your project management, team collaboration, and task tracking inside your chat window.
What your AI agents can do
Complete todo
Marks a specific to-do item as done, keeping it visible but marked as complete.
Create comment
Adds a comment to any Basecamp recording, like a message or document, and notifies all subscribers.
Create project
Sets up a brand-new Basecamp project with all default tools (message board, to-do set, schedule) enabled.
Initializes a new Basecamp project or modifies the name and description of an existing one.
Creates, updates, lists, and marks to-do items as completed or pending, assigning them to specific team members.
Reads messages from project boards and allows you to add comments to any recording for status updates or feedback.
Retrieves full profiles for individual people or lists all people within a specific project.
Gets full details for a specific project, including necessary IDs for its associated message board and to-do set.
Retrieves a list of all projects, optionally filtering by status (active, archived, or trashed).
Ask AI about this MCP
Supported MCP Clients
Gemini Waiting for input…
019dd0c0complete todo
Marks a specific to-do item as done, keeping it visible but marked as complete.
019dd0c0create comment
Adds a comment to any Basecamp recording, like a message or document, and notifies all subscribers.
019dd0c0create project
Sets up a brand-new Basecamp project with all default tools (message board, to-do set, schedule) enabled.
019dd0c0create todo
Adds a new to-do item to a specific list, allowing you to set assignees and due dates.
019dd0c0get message
Retrieves the full content and details of a single Basecamp message.
019dd0c0get my profile
Confirms your connection to Basecamp and retrieves your authenticated user profile details.
019dd0c0get person
Looks up and retrieves full contact and role details for any team member or assignee.
019dd0c0get project
Gets complete details for a specific project, including its associated tool IDs.
019dd0c0get todo
Retrieves all details for a single to-do item.
019dd0c0list messages
Lists the titles, authors, and dates of all messages posted on a project's message board.
019dd0c0list people
Gets a list of every person in your Basecamp account, useful for finding IDs.
019dd0c0list project people
Lists all people assigned to a specific project, showing their roles and emails.
019dd0c0list projects
Returns a list of all your Basecamp projects, optionally filtering by status (active, archived, or trashed).
019dd0c0list todos
By default returns only pending (not completed) items. Set completed to true to see completed items instead. Each to-do includes its content, assignees, due date, completion status, and comments count. You need the todolist_id which can be found via the project dock. List all to-dos in a specific to-do list
019dd0c0uncomplete todo
Use this when a previously completed task needs to be reopened or reworked. Mark a completed to-do item as pending again
019dd0c0update 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
019dd0c0update 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
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Basecamp, then connect any of our 4,500+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,500+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
What you can do with this MCP connector
Basecamp MCP Server hooks your AI agent straight into your Basecamp workspace. You'll manage projects, track tasks, and talk to your team—all without touching the Basecamp UI. Your agent handles the whole workflow, keeping your project management and comms right inside your chat window.
Creating and updating projects: You can initialize a brand-new Basecamp project using create_project or modify an existing one's name or description with update_project. To get the full picture of any project, get_project retrieves complete details, including the necessary IDs for its message board and to-do set. You can also check out a list of all your projects using list_projects, which lets you filter by status (active, archived, or trashed).
Managing to-do items: You can use create_todo to add a new task to a specific list, setting assignees and due dates. To see what's pending, list_todos pulls details for all incomplete items; you just need the todolist_id from the project dock. If you need to see finished work, list_todos lets you set completed to true.
You can update a task's content with update_todo or mark it as done using complete_todo. If a task needs to be reopened, use uncomplete_todo to mark it as pending again. You can also modify an existing to-do item's details with update_todo.
Reviewing team communications: Your agent reads messages from project boards via list_messages, showing titles, authors, and dates. You can grab the full details of a single message with get_message. To jump into a conversation, create_comment adds a comment to any Basecamp recording—like a message or document—and notifies everyone subscribed. You can also check out a list of every person in your Basecamp account using list_people, and find specific team member details for any person with get_person or by listing all people assigned to a specific project with list_project_people.
You can also confirm your connection and pull your own profile details with get_my_profile.
How Basecamp MCP Works
- 1 Subscribe to the server and provide your Basecamp OAuth access token and account ID.
- 2 Your AI agent calls a tool, like
list_projects, which requests a list of all your projects. - 3 The server sends the list back to your agent. You then prompt the agent to 'check the to-dos for the Marketing Website Redesign project,' and the agent runs
list_todos.
The bottom line is, your agent handles the back-and-forth with Basecamp, so you never have to switch windows or copy a project ID.
Who Is Basecamp MCP For?
The Project Manager who is tired of switching between Basecamp, Slack, and Jira just to track a simple task. It's for the Team Lead who needs to review project messages and assign follow-ups without opening the web app. If your job requires keeping track of multiple people's progress across several projects, this saves context switching.
Uses the server to create tasks, assign team members, and track completion status across multiple projects via simple AI commands.
Monitors project boards and reviews messages, then uses the agent to add comments or check project status without leaving their current workflow.
Queries project states and to-do progress directly from the chat to report status updates to stakeholders or track dependencies.
What Changes When You Connect
- Task Completion: You don't have to click 'mark as done.' Use
complete_todoto mark a to-do item as finished, anduncomplete_todoif you need to reopen it for rework. - Real-Time Communication: Read all project announcements and team decisions by running
list_messages. You can also usecreate_commentto add feedback directly to any message or document. - Task Assignment: Need to assign something? Use
create_todoto build a new task, specifying thetodolist_id, content, assignees, and due date all in one prompt. - Team Visibility: Finding an assignee ID is a pain. Use
list_peopleorlist_project_peopleto get the required IDs and roles before running any update tool. - Project Discovery: Instead of clicking through folders, run
list_projectsto get a clean list of every project. You can filter by status (active, archived, trashed) to narrow your focus. - Contextual Deep Dive: Need to know what a project is? Use
get_projectto retrieve all metadata for a specific project, ensuring you have the necessary IDs for subsequent tools.
Real-World Use Cases
Project Kickoff and Task Delegation
A project manager starts a new initiative. Instead of manually setting up a project, they ask the agent to run create_project. Then, they delegate tasks by calling create_todo, specifying the list ID, the task title, and the team member IDs. The entire project structure and first wave of tasks are built instantly.
Status Report Generation
A remote team member needs to report on a project. They ask the agent to list_projects to find the ID, then use list_todos to pull all open items. Finally, they use list_messages to summarize recent decisions, compiling a full status report without ever leaving the chat.
Handling Follow-Ups and Feedback
A key decision was made in a message board. A team member can't find the thread. They ask the agent to get_message using the recording ID. They then use create_comment to provide feedback directly on that message, ensuring the feedback is tied to the right context.
Auditing Team Membership
An operations engineer needs to know who is on the 'Marketing Redesign' project. They run list_project_people to get a roster of names, emails, and roles. This data is then used to verify if the correct people were assigned to the project tasks.
The Tradeoffs
Manual ID Hunting
Trying to manually find the message_board_id or todolist_id by clicking through the Basecamp UI's settings tabs.
→
Use get_project or list_projects first. These tools give you the full project metadata, including the necessary IDs for the message boards and to-do sets, so you don't have to hunt for them.
Sequential Task Updates
Running get_person to find an ID, then copying that ID into a separate create_todo command, then repeating the copy-paste process for every task.
→
The agent handles the flow. Just tell the agent, 'Assign this task to the Lead.' The agent runs list_people and selects the correct ID internally to execute create_todo for you.
Incomplete Status Updates
Just sending a message saying 'Done' without updating the task status in Basecamp, leading to an inaccurate project status view.
→
Always use complete_todo when a task is finished. If the task needs to be reopened, use uncomplete_todo. This keeps the task history clean and the project status accurate.
When It Fits, When It Doesn't
Use this server if your core job is project coordination across multiple teams and projects. It's for people who need to manage the lifecycle of tasks, messages, and project scopes.
Don't use this if:
* You only need to view a static document or file that isn't tied to a specific to-do or message board. You'll need a file-sharing or document API instead.
* You are managing complex, timed schedules that require external calendar synchronization (like Google Calendar). For that, use a dedicated calendar integration.
Use this when:
* You need to confirm who is assigned to a project (list_project_people).
* You need to update a task's status and assignees simultaneously (create_todo).
* You need to read a message board and then immediately add a status comment to that message (list_messages then create_comment).
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Basecamp. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 17 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Available Capabilities
Tracking team status shouldn't feel like navigating a labyrinth of tabs.
Today, checking a project's status means opening the Basecamp site. You jump to the project dashboard, scroll through the message board to see the last decision, then click the 'To-Do' tab. If you need to know who is responsible, you might have to open a separate 'People' tab or find the name in the message thread, and then copy that name/ID to manually update a spreadsheet. It’s clicks, context switching, and copy-pasting.
With the Basecamp MCP Server, you just tell your agent: 'What's the status of the Q3 launch?' The agent runs `list_projects` to find the project, then uses `list_messages` and `list_todos` to gather the data. It compiles the status report and hands it back to you in a single response. The process is one prompt, one answer.
Using Basecamp MCP Server: Manage Projects with `create_project`
Before, starting a new project meant a whole setup ritual: creating the project, then going into settings to enable the message board, then enabling the to-do set, then setting up the schedule. It was a multi-step, manual setup process that often got skipped or done incorrectly.
Now, you ask your agent to run `create_project`. It initializes the project and ensures all the core tools (message board, to-do set, schedule) are active. You get a fully functional, structured project ready for work, all in one command. No manual setup required.
Common Questions About Basecamp MCP
How do I use the `create_todo` tool to assign a task to someone? +
You must provide the todolist_id, the task content, and the assignee IDs in your prompt. The agent will prompt you for these specific IDs if you don't provide them upfront, ensuring the task goes to the right person.
Can I check my own profile using `get_my_profile`? +
Yes, running get_my_profile verifies that your agent is connected and authenticated correctly to Basecamp, confirming your access permissions before you start working.
What is the difference between `list_messages` and `get_message`? +
list_messages gives you a summary of all messages on a board (title, author, date). get_message retrieves the complete, full-text content of one specific message.
I finished a task, how do I update the status using `complete_todo`? +
You need to provide the unique ID of the to-do item. The complete_todo tool marks the item as done, keeping it visible in the list history.
How do I find out who is on a specific project team using `list_project_people`? +
You must first provide the project ID. This tool then returns a roster of names, emails, and roles specific to that project, without needing to check the project's settings page.
How do I list all projects and check their status using `list_projects`? +
The list_projects tool returns all projects, optionally filtered by status (active, archived, or trashed). This lets you see a project's name, description, purpose, and if its internal tools (like the message board or to-do set) are enabled.
What do I use `list_people` for, and how does it differ from `list_project_people`? +
list_people gives you a full directory of everyone in your entire Basecamp account. Use list_project_people when you only need the team members specific to one project, showing their roles and emails there.
If I need to update a project name or description, which tool should I use: `update_project` or `update_todo`? +
Use update_project for changes to the project itself, like renaming it or updating its overall description. update_todo only handles changes to a specific to-do item's details, not the parent project container.
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.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
More in this category
Finmei
Manage expenses, tax rates, and payments through conversational AI agents with Finmei.
Sproof
Manage digital signatures, documents, and contacts on Sproof with AI agents.
ArcXP
Automate newsroom publishing via ArcXP — manage, search, and update articles, photos, and videos directly from any AI agent.
You might also like
InvoiceXpress (Online Invoicing)
Manage invoicing via InvoiceXpress — create clients, track payments, and manage invoices and estimates in Portugal.
IoTeX (IoTeX Block Explorer API)
Access IoTeX blockchain data — query accounts, blocks, transactions, and token details directly from your AI agent.
Innform
Manage learners, courses, and results via Innform LMS API.