# Teamwork Projects MCP for AI Agents AI Agent Connect

> Teamwork Projects MCP connects your AI agent to your project management platform. Manage tasks, milestones, and time logs without switching tabs. It lets your agent create work items, update statuses, and post project messages directly from your chat interface. This is the primary way to handle project delivery for agencies and professional services who need to keep things moving without the friction of manual data entry.

## Overview
- **Category:** productivity
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_cv2XpenHTYuvaP47wMCLQg0gn8VyBhw5TboAqDMl/ai-agent-connect
- **Tags:** task-management, milestone-tracking, time-logging, project-delivery, team-collaboration, workflow-automation

## Description

Connect Teamwork to any AI agent and manage your project delivery platform by creating and tracking tasks, managing milestones, logging time, and posting messages through natural conversation. It turns your project management platform into a conversational workspace where you can handle the administrative side of project delivery without leaving your chat. Because Vinkius makes it so easy to connect these tools, you can keep your focus on the actual work while your agent handles the overhead of keeping everything organized. It's about getting the project moving without the friction of manual data entry. You can ask your agent to summarize project messages, find specific files, or log your hours for the day as you finish them. It turns a complex dashboard into a simple conversation. No more hunting for project IDs or manually copy-pasting task names between apps. You just tell your agent what needs to get done, and it handles the updates in Teamwork for you.

## Tools

### create_message
Post a new message in a project. This allows you to send announcements to the whole team easily.

### create_milestone
Create a new milestone in a project. Use this to set big goals and deadlines for your project.

### create_project
Create a new project. Use this to start a new engagement or internal initiative instantly.

### create_task
Create a new task with content, tasklist_id, assignee_ids, and due dates. This lets you build out your project plan quickly.

### create_time_entry
Log a new time entry with a description, duration, and date. Use this to keep your billable hours accurate.

### delete_task
Delete a task from your project list. This helps you clean up your workspace when work is finished.

### list_files
List all files in a project. This makes it easy to find attachments and documents quickly.

### get_project
Get details of a specific project. Use this to check the status and metadata of any project.

### get_task
Get details of a specific task. This is useful for checking the status and requirements of a single item.

### get_current_user
Use this to verify connection and identify your user ID. It ensures your agent is linked to the right account.

### list_messages
List all messages in a project. Use this to see the latest discussions and updates from your team.

### list_milestones
List all milestones in a project. This helps you keep an eye on major deadlines and goals.

### list_projects
List all projects accessible to the user. Use this to get a high level view of your entire workload.

### list_tasklists
List all task lists in a project. This helps you organize your work into specific categories.

### list_tasks
List all tasks in a project. Use this to see every item on your current project's to-do list.

### list_time_entries
List all time entries in a project. This helps you audit how much time was spent on specific tasks.

### update_task
Update an existing task. Use this to change statuses, dates, or descriptions as work progresses.

## Prompt Examples

**Prompt:** 
```
Show me all my projects.
```

**Response:** 
```
I found 4 active projects in your Teamwork account:

| Project Name | Status |
| :--- | :--- |
| Website Redesign | In Progress |
| Mobile App Launch | Planning |
| Q1 Marketing Campaign | Active |
| Client Onboarding | Pending |
```

**Prompt:** 
```
List all tasks in project 12345.
```

**Response:** 
```
Here are the 12 tasks currently assigned to project 12345:

* **Design Homepage** (Due: 2025-04-15)
* **Update API Docs**
* **Fix Login Bug**
* **Launch Campaign**

*(Showing 4 of 12 tasks...)*
```

**Prompt:** 
```
Create a milestone 'Phase 1 Complete' with deadline 2025-05-01 in project 12345.
```

**Response:** 
```
Done! I've added the milestone **Phase 1 Complete** to project 12345.

**Details:**
* **Deadline:** 2025-05-01
* **Status:** Created successfully.
```

## Capabilities

### Create project tasks
Build out your project plan by adding tasks with assignees and due dates.

### Log time entries
Record your work hours against specific projects as you complete them.

### Post project messages
Send announcements and updates to your entire team on project boards.

### Track project milestones
Monitor major deadlines and project goals in one glance.

### Access project files
List and find all attachments and documents associated with a project.

### Retrieve project details
Get specific metadata and status updates for any project in your account.

## Use Cases

### Setting up a new client engagement
A manager needs to spin up a new project. They ask the agent to `create_project` and then use `create_task` to build out the initial research and discovery phase.

### Logging hours and updating status
A developer finishes a feature. They tell the agent to `create_time_entry` for the last two hours and `update_task` to reflect that the work is now complete.

### Getting a project status summary
A team lead wants a quick update. They ask the agent to `list_messages` and `list_milestones` to see what the team has accomplished this week.

### Finding project documents
An admin needs to find a specific contract. They ask the agent to `list_files` to locate the correct document within the project folder.

## Benefits

- Stop manual data entry by using `create_task` to build out project plans instantly. This saves you from clicking through multiple screens just to set up a new initiative.
- Keep records accurate by using `create_time_entry` to log work as it happens. You can tell your agent to record your hours as soon as you finish a block of work.
- Stay updated on project status by pulling data with `list_tasks` and `list_milestones`. Your agent can give you a quick summary of what's done and what's next.
- Centralize communication by using `create_message` to post updates to the whole team. This keeps everyone on the same page without sending extra emails or pings.
- Quickly find resources by using `list_files` to see all project attachments. Your agent can help you locate specific documents or assets in seconds without digging through folders.

## How It Works

The bottom line is you get a hands-free way to manage project logistics through a chat interface.

1. Subscribe to the Teamwork Projects MCP on Vinkius.
2. Provide your Teamwork site name and Access Token.
3. Start asking your agent to manage tasks or log time in your preferred AI client.

## Frequently Asked Questions

**Can the Teamwork Projects MCP create tasks for me?**
Yes, your agent can create new tasks with specific content, assignees, and due dates. This means you can build out your entire project plan just by describing it in chat.

**How do I log my work hours using this Connector?**
You can simply tell your agent how much time you spent on a specific task. It will use the Connector to log that entry automatically, keeping your billable hours accurate.

**Can my agent see project files?**
Yes, your agent can list and help you find files and attachments within your projects. This makes it much faster to locate specific documents without manual searching.

**Does the Teamwork Projects MCP work for agencies?**
It is specifically designed for agencies and professional services. It helps manage the high-volume task tracking and time logging that these industries require.

**Can I post messages to my team via the AI?**
Yes, you can ask your agent to post announcements or updates to a project message board. This keeps your team informed without you having to leave your current workspace.

**How do I set up the Teamwork Projects MCP?**
Once you subscribe on Vinkius, you just need to provide your Teamwork site name and your Access Token. After that, your agent is ready to manage your projects.

**How do I get my Teamwork Access Token?**
Log in to Teamwork, go to your Profile picture > My Profile > Developer, and generate a Personal Access Token.

**Can I create tasks with assignees?**
Yes! Use the create_task action with a JSON body that includes content, tasklist_id, and responsible-party-ids for assignment.

**Can I log time against a project?**
Yes! Use the create_time_entry action with a JSON body that includes description, duration (in minutes or seconds), and date.

**Can I retrieve project milestones?**
Yes! Use the list_milestones action to get all project milestones and their deadlines.