# Basecamp MCP > Basecamp MCP connects your AI agent directly to your entire Basecamp workspace. You manage projects, track tasks, share files, and review team messages through simple conversation. Get full visibility into project status without ever leaving your chat window. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** task-tracking, team-communication, file-sharing, project-scheduling, to-do-lists, message-boards ## Description You can take complete control of your team's workflow using this MCP. Instead of navigating multiple dashboards or digging through old message threads, you just talk to your agent. You tell it to list all active projects and get the details for a specific one; it handles the retrieval. Need an update? Ask your agent to read messages from a project board or even add comments directly to a recorded document. If someone misses a step, you can ask it to create new tasks, assign them to team members, and set due dates automatically. This MCP lets you monitor who's available on the team by listing people and checking their roles. It keeps all that critical project data—tasks, messages, schedules, files—accessible through one chat interface. When you connect this MCP via Vinkius, your agent acts as a single pane of glass for everything happening in Basecamp. ## Tools ### complete_todo Marks an existing to-do item as finished, keeping it visible in the list but marked as done. ### create_comment Adds a comment to any recording, such as a message or document, notifying all relevant subscribers. ### create_project Sets up an entirely new project in Basecamp with all the standard tools (message boards, schedules) enabled by default. ### create_todo Generates a brand-new to-do item within a specific list, allowing you to assign it and set a due date. ### get_message Retrieves the complete details of any single message posted on the platform. ### get_my_profile Checks your own authenticated Basecamp user profile to confirm connectivity and access permissions. ### get_person Looks up full details about any specific team member or potential assignee by name or ID. ### get_project Retrieves all detailed information for a single project, including the IDs needed to access its components. ### get_todo Gets full details about one specific to-do item in a list. ### list_messages Lists all recent messages on a project board, giving you titles and content previews from different authors. ### list_people Provides a comprehensive list of everyone in your Basecamp account to find correct assignee IDs. ### list_project_people Filters the team roster for one project, showing names, emails, and roles only for that specific group. ### list_projects Retrieves a list of all projects in your account, optionally filtering by status (active, archived, or trashed). ### list_todos Shows you all to-do items within one specific list, including completion status and assignees. ### uncomplete_todo Reopens a task that was previously marked as complete, allowing it to be worked on again. ### update_project Modifies the name or description of an existing project. ### update_todo Makes changes to the content or details of an existing to-do item. ## Prompt Examples **Prompt:** ``` List all my active projects in Basecamp. ``` **Response:** ``` I've found 4 active projects in your account: 'Product Launch Q3' (ID: 48291034), 'Marketing Website Redesign' (ID: 48291078), 'Engineering Sprint 22' (ID: 48291102), and 'Client Onboarding' (ID: 48291156). Would you like to see the details or to-dos for any of these? ``` **Prompt:** ``` Create a new to-do 'Review design mockups' in list 592001 and assign it to person 10293 with a due date of 2026-05-15. ``` **Response:** ``` Done! I've created the to-do 'Review design mockups' in your to-do list. It has been assigned to Sarah M. (ID: 10293) with a due date of May 15, 2026. The new to-do ID is 8830122. Would you like to add a detailed description? ``` **Prompt:** ``` Show me the latest messages on the message board of project 48291034. ``` **Response:** ``` I've retrieved 3 recent messages from the project board: 'Sprint 22 Kickoff Notes' by James T. (posted 2 hours ago), 'Q3 OKR Alignment Update' by Lisa K. (posted yesterday), and 'Design System Migration Plan' by Marcus R. (posted 3 days ago). Would you like to read the full content of any of these messages? ``` ## Capabilities ### Get Project Status and Details List all active or archived projects to get an overview of the entire organization's work. ### Manage To-Do Tasks Create, update, complete, or reopen tasks assigned across any project list. ### Review Team Communication Read messages from a project board and add comments to specific documents or recordings. ### Check Team Composition List all people in the account or filter by a single project to verify roles, emails, and assignees. ### Create New Projects Initialize an entirely new project with default tools enabled for immediate use. ## Use Cases ### The Kickoff Meeting Summary A PM asks their agent to list all active projects and then requests a summary of recent messages from Project X. The agent pulls up key decisions, identifies the last person who commented on the schedule, and presents it all in one reply. ### Handling Task Delegation A team lead needs to assign three new tasks for the next sprint. They ask their agent to create new to-do items in a specific list, assigning them individually and setting due dates for each person. ### Catching Up on Project X A remote employee needs to know what happened while they were offline. They ask the agent to list messages on the board and check if any tasks have been completed since yesterday, getting a full status report instantly. ### Project Scope Change The scope changes late in the week. The team lead asks their agent to update the project's description immediately and then creates new related tasks for the engineering team by assigning them specific details. ## Benefits - Stop jumping between tabs. You can list all your active projects and get the full details for any single one by simply asking your agent to do it. - Keep track of assignments effortlessly. Instead of opening a dashboard, you ask your agent to create new tasks or update existing ones across different lists. - Maintain perfect communication records. You can read recent messages from a project board and add comments directly to any document without switching context. - Verify team availability instantly. Use the list people tool to find specific assignee IDs or check roles for an entire group within one project. - Control your workflow end-to-end. If a task is finished, you can use complete_todo; if it needs rework, uncomplete_todo flips the switch immediately. ## How It Works The bottom line is you get instant command-line access to the entire Basecamp platform without opening the web app. 1. Subscribe to the Basecamp MCP and provide your OAuth access token and account ID. 2. Connect this MCP to your preferred AI client (Claude, Cursor, or any compatible agent). 3. Start giving commands in natural language to manage projects and tasks. ## Frequently Asked Questions **How do I list projects using the Basecamp MCP?** You use the list_projects tool to see all projects. This function lets you filter by status, so you can quickly separate active work from archived or trashed items. **Can I assign tasks with the Basecamp MCP?** Yes, you use create_todo. This tool requires a to-do list ID and allows you to set an assignee and due date when generating a new task. **What if a task is done but needs rework using Basecamp MCP?** You can't just delete it. To reopen a completed item, you must use the uncomplete_todo tool which marks the task as pending again for action. **How do I check who works on my project with Basecamp MCP?** Use the list_project_people tool. This is better than listing all people because it filters the roster down to only those assigned to that specific project, showing their roles. **Does the Basecamp MCP let me add comments anywhere?** Yes, you can use create_comment to add feedback or status updates. This works on almost any recording, like a message board post or a document.