# Teamwork Projects MCP > The Teamwork Projects MCP lets your agent manage every detail of your project delivery lifecycle. You can create new projects, assign tasks with due dates, set critical milestones, and log time entries—all without opening the web app. It handles task creation, message posting, file listing, and tracking project progress through natural conversation. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** task-management, milestone-tracking, time-logging, project-delivery, team-collaboration, workflow-automation ## Description Think of this MCP as a direct line into your entire project management workflow. Instead of navigating multiple tabs to update status reports or ping teammates, you simply ask your agent what needs doing. You tell it, "I need to add the design review milestone for Q3." The connector handles the rest, updating the official record and ensuring everyone sees the deadline pop up. It manages everything from building out new projects to logging hours against specific work items. Need a status update? Your agent can list all project messages or pull together every time entry associated with that client account. This connection lets you manage milestones, create tasks, post announcements, and even list attachments for review—all through your AI client interface. When you connect this MCP via Vinkius, you get access to the full scope of Teamwork's functionality, turning a complex web app into simple conversation. It’s about getting those critical project updates instantly, whether it's checking on file attachments or listing all open tasks. ## Tools ### create_message Posts a title and body content as a new discussion message in an active project. ### create_milestone Establishes a major project checkpoint, requiring a title and a final deadline date. ### create_project Sets up an entirely new work area by defining the core name and optional settings for a project. ### create_task Generates a specific deliverable, assigning it to users and setting firm due dates. ### create_time_entry Records spent time by providing a description, the duration of work, and the date it occurred. ### delete_task Permanently removes an existing task from its associated project board. ### list_files Retrieves a list of all documents and attachments stored within a specific project folder. ### get_project Pulls up full details for one selected project, including settings and status reports. ### get_task Fetches all specific information about a single task by its ID. ### get_current_user Confirms your identity and retrieves the authenticated user's profile details for verification. ### list_messages Displays a chronological list of all posts and discussions within an active project feed. ### list_milestones Gives you a summary view of all scheduled milestones for the current project. ### list_projects Provides an overview and list of every project accessible to your account. ### list_tasklists Lists all defined task groups within a selected project, helping you narrow down searches. ### list_tasks Retrieves an exhaustive list of every open and closed task in the current project. ### list_time_entries Pulls up a detailed history and record of all submitted time entries for a given period. ### update_task Modifies the details, assignee, or status of an existing task after it has been created. ## Prompt Examples **Prompt:** ``` Show me all my projects. ``` **Response:** ``` Found 4 projects: 1. Website Redesign. 2. Mobile App Launch. 3. Q1 Marketing Campaign. 4. Client Onboarding. ``` **Prompt:** ``` List all tasks in project 12345. ``` **Response:** ``` Found 12 tasks: 1. Design Homepage (Due: 2025-04-15). 2. Update API Docs. 3. Fix Login Bug. 4. Launch Campaign. ``` **Prompt:** ``` Create a milestone 'Phase 1 Complete' with deadline 2025-05-01 in project 12345. ``` **Response:** ``` Milestone created successfully! 'Phase 1 Complete' added to project 12345 with deadline 2025-05-01. ``` ## Capabilities ### Organize and initialize projects Create new work environments, retrieve existing project details, and list all available client projects. ### Manage task lifecycles Generate tasks, update their status or assignees, delete old items, and get detailed information on specific assignments. ### Track progress and deadlines Establish key project milestones with dates, list all upcoming deadlines, and retrieve current task lists. ### Monitor time and resources Log new hours worked against a specific job or view comprehensive lists of past time entries for billing. ### Communicate project status Write announcements, post discussions in the project feed, and retrieve message history. ### Access project assets List all files attached to a project or check general details about specific projects and tasks. ## Use Cases ### The Project Kickoff A project manager needs to start a new initiative. They ask their agent, 'Start the marketing campaign.' The agent uses create_project to set up the work area, then uses create_milestone and list_tasks to immediately define the first three major deliverables and track them. ### The Weekly Review An operations lead needs a status update. They prompt their agent to 'Show me all outstanding tasks for Q2.' The agent uses list_tasks, pulls in due dates, and identifies exactly which assignments need attention before the next team meeting. ### The Client Follow-Up A consultant finishes a client call. They ask their agent to 'Log 2 hours of time for the Acme Corp account.' The agent uses create_time_entry, automatically recording the duration and description without opening any billing portal. ### The Team Handoff A team lead finishes a design draft. They ask their agent to 'Update Task ID 500 to completed and assign it to John.' The agent uses update_task, closing the loop on that deliverable immediately. ## Benefits - You never have to switch apps again. Instead of opening Teamwork just to create a task or log time, you simply ask your agent to do it. This keeps all your work history contained within the chat interface. - Never miss a deadline detail. Use this MCP to set and track milestones—your agent handles recording the title and the required due date automatically when you prompt it. - Project visibility is instant. Need to know what was decided last week? You can list messages or check file attachments right from your chat, pulling up project files instantly. - Streamline team handoffs. When a teammate finishes their work, use this MCP to update the task status and assign the next steps to someone else in one go. - Simplify time tracking. Instead of going into the clock-in section, you can tell your agent that you need to create a time entry for three hours of client consultation, logging it instantly. ## How It Works The bottom line is that you manage complex, structured data from Teamwork entirely within your chat interface. 1. Subscribe to this MCP on Vinkius and enter your Teamwork site name along with the necessary Access Token. 2. Your AI client authenticates, connecting directly to the Teamwork API endpoints using the provided credentials. 3. You begin giving commands in natural language (e.g., "Create a new project called Widget Redesign"), and the agent executes the required tool calls. ## Frequently Asked Questions **How do I find out what tasks are due in my projects using Teamwork Projects MCP?** You can use list_tasks to pull a comprehensive list of all assignments within your chosen project. This gives you an immediate view of everything that needs attention and helps you prioritize your day. **Can I create milestones using the Teamwork Projects MCP?** Yes, you can use create_milestone to officially mark a project phase completion. Just provide a title and the required deadline date, and it gets added directly to the project timeline. **What is the best way to log hours using Teamwork Projects MCP?** You use create_time_entry for this. You only need to provide three pieces of information: a description, the duration of work, and the specific date you performed the task. **Does the Teamwork Projects MCP allow me to update tasks?** Yes, you can use update_task. This is useful if an assignee changes or if a deadline needs to be pushed back after initial creation. **Can I see all project files using the Teamwork Projects MCP?** You list files using the list_files tool. Just tell your agent which project you're working on, and it pulls up a full inventory of attached documents.