# Worktile MCP

> Worktile connects your AI agent directly to its entire project management suite. Instead of navigating menus, you talk to Worktile to list projects, track tasks, update statuses, send team messages, and check organizational details—all in natural conversation.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** task-tracking, team-collaboration, project-planning, workflow-automation, task-management, team-communication

## Description

Managing a complex team workflow shouldn't require jumping between tabs and filling out forms. This MCP connects your AI agent straight into Worktile, turning project tracking, task assignment, and team communication into one continuous conversation. Your agent becomes an instant operations assistant for all things work-related. You can ask it to list all active projects or create a new task with full details, like the assignee and description, without ever opening the Worktile web app. It handles everything from updating statuses to sending messages in specific team channels. Because this connection is housed within the Vinkius catalog, you connect once using your preferred client (like Claude or Cursor) and instantly get access to all these core functions. You manage the entire lifecycle of a project—from initial planning to final communication—all through plain language prompts.

## Tools

### create_task
Generates a brand new task item within your Worktile project.

### get_project
Retrieves specific details for one of your defined projects.

### get_team_info
Pulls general information about your entire organization and team structure.

### list_channels
Provides a list of all current message channels available for updates.

### list_members
Retrieves the names and details of every person in your organization.

### list_projects
Lists all active agile projects you have set up in Worktile.

### list_task_states
Shows the exact possible statuses a task can hold within a specific project's workflow.

### list_tasks
Lists all current tasks associated with an identified project.

### send_message
Sends text updates or announcements to a specific team message channel.

### update_task
Changes the status, assignee, or details of an already existing task item.

## Prompt Examples

**Prompt:** 
```
List all my active projects on Worktile.
```

**Response:** 
```
I've retrieved your Worktile projects. You have 3 active projects: 'Marketing Q3', 'New Product Launch', and 'Internal HR'. Which one would you like to view tasks for?
```

**Prompt:** 
```
Create a task in project 'Marketing Q3' titled 'Finalize social media assets'.
```

**Response:** 
```
Done! I've created the task 'Finalize social media assets' in the 'Marketing Q3' project. Would you like to assign it to a team member?
```

**Prompt:** 
```
Post an update to the 'General' channel saying 'The project kickoff has been moved to 2 PM'.
```

**Response:** 
```
I've posted your update to the 'General' channel. Your team has been notified that the kickoff is now at 2 PM.
```

## Capabilities

### List team projects
You can retrieve a list of all accessible agile projects in your workspace.

### Manage tasks and updates
Create new work items, update the status of existing tasks, or get detailed information about specific assignments.

### Check team structure
Get a list of all organization members and view overall team details.

### Monitor project workflow
Browse the precise possible states for tasks within any given project to understand your process flow.

### Communicate with the team
List message channels and send instant updates or announcements directly to your work group.

## Use Cases

### The Project Kickoff Update
A Product Owner needs to tell their dev team that the scope changed. They ask their agent, 'Update task Alpha in New Product Launch status and notify everyone.' The agent uses `update_task` and then triggers a message via `send_message`, ensuring the change is tracked and visible immediately.

### The Status Check
A Team Lead needs to know which tasks are stalled. They ask their agent, 'List all tasks in Marketing Q3 that aren't assigned.' The agent uses `list_tasks` and filters the results for them, saving a deep dive into the Worktile interface.

### Onboarding New Staff
An Operations Manager needs to know who is on the new sales team. They simply ask their agent, 'Show me all members in the Sales department.' The agent uses `list_members` and provides a clean roster.

### The Workflow Question
A Project Manager isn't sure how to move a task from 'Drafting' to 'Review'. They ask their agent, 'What are the possible states for this project?' The agent uses `list_task_states` and explains the full process flow.

## Benefits

- Stop clicking through dashboards. You can tell your agent to 'list all my projects' or 'create a task in Marketing Q3,' getting the result instantly without leaving your chat window.
- Team communication becomes actionable. Use the `send_message` tool to broadcast an update to General, letting everyone know about the new deadline instead of making multiple announcements.
- Get a full picture of your team structure by running `list_members`. You don't have to open the directory; you just ask your agent for who works where.
- Task management is streamlined. Instead of remembering which status button to click, simply prompt your agent to 'update task XYZ to completed,' using the `update_task` tool.
- Project overview is instant. You can run `list_projects` and then immediately follow up by asking for details on a specific project using `get_project`, keeping the conversation flowing.

## How It Works

The bottom line is, you talk to your agent like a person, and the agent talks to Worktile for you, pulling data and performing actions automatically.

1. Subscribe to this MCP using your Worktile Client ID and Client Secret.
2. Connect the service to your agent via any MCP-compatible client like Cursor or Windsurf.
3. Start talking to your agent. Just ask it to 'list my projects' or 'send an update to General'. The agent handles the rest.

## Frequently Asked Questions

**How do I list projects using Worktile MCP?**
You simply ask your agent to 'list all accessible agile projects.' The agent uses the `list_projects` tool and provides you with a clean, actionable list of every project name available in your workspace.

**Can I update task status using Worktile MCP?**
Yes. You use the `update_task` function by telling your agent exactly which task to modify and what its new status should be, saving you from clicking through multiple menus in the application.

**What is the best way to send a message with Worktile MCP?**
First, use `list_channels` if you aren't sure of the channel name. Then, prompt your agent: 'Send this update about the deadline change to General.' The agent handles sending the message using `send_message`.

**Does Worktile MCP help me see who is on my team?**
Absolutely. You can use `list_members` to retrieve a clean roster of all organization members and get details about your overall team setup without logging into the directory section.

**Can Worktile MCP create tasks in multiple projects?**
You must specify which project you want the task in. Use `create_task` and make sure to include the project name or ID so the agent knows where to place the new work item.