# Teambition MCP

> Teambition MCP connects your AI agent directly into Alibaba's Teambition project management platform. Instead of navigating complex dashboards or clicking through multiple screens, you simply ask your agent to perform actions like listing projects, creating new tasks, or updating team member statuses using natural conversation. It turns large-scale corporate workflow tracking into a simple dialogue.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Tags:** task-tracking, workflow-automation, team-collaboration, project-planning, task-management, enterprise-software

## Description

Managing an entire team's workload usually means jumping between tabs and copy-pasting data—a painful, click-heavy process. This MCP changes that entirely. By connecting Teambition to your agent, you can handle complex project workflows by simply talking to it. Your agent acts like a real-time project assistant. You ask it to list all active projects or find out who's assigned to 'Q3 Marketing Plan,' and it gives you the answer instantly. It doesn't just read data; it lets you perform actions. Need to update a task status because a developer finished their part? Just tell your agent, and it handles the record change in Teambition. This level of project control is what makes Vinkius such a critical resource for keeping enterprise tools accessible through conversation.

## Tools

### create_task
Creates an entirely new task record within Teambition for a specific project.

### get_org_info
Fetches high-level information and details about the overall organization structure in Teambition.

### get_project
Retrieves specific, detailed data for a single named project within Teambition.

### list_members
Generates a list of all users who are currently members of a specified project.

### list_projects
Retrieves a comprehensive list of every accessible project managed by the organization.

### list_stages
Lists all distinct stages or workflow steps within a defined task group.

### list_task_groups
Shows the major grouping containers used for organizing tasks inside a project.

### list_tasks
Retrieves a list of specific tasks, along with their current status and assignee, within a given project.

### list_users
Lists all available individual users registered within the Teambition organization.

### update_task
Modifies an existing task's attributes, such as changing its status or updating the responsible party.

## Prompt Examples

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

**Response:** 
```
I've retrieved your Teambition projects. You have 4 active projects, including 'Website Redesign' and 'Q2 Marketing Plan'. Which one would you like to explore?
```

**Prompt:** 
```
Create a task in project 'Product Launch' titled 'Review landing page copy'.
```

**Response:** 
```
Done! I've created the task 'Review landing page copy' in the 'Product Launch' project. Would you like to assign it to someone or set a due date?
```

**Prompt:** 
```
Show me the tasks for project 'Internal Audit'.
```

**Response:** 
```
I've listed the tasks for 'Internal Audit'. There are 8 pending tasks, including 'Inventory check' and 'Compliance review'. Should I filter them by status or assignee?
```

## Capabilities

### Map Project Status
Retrieve detailed information on projects, monitor their overall progress, and list all associated stages.

### Manage Tasks
Create new tasks for specific projects or update existing task details like status, assignee, and due date.

### Identify Team Members
List all project members, organization users, and retrieve high-level structural information about your company's Teambition setup.

## Use Cases

### The Status Check Nightmare
A Project Manager needs to know if three different teams are ready for a product launch, but the status lives in three separate projects. They ask their agent to list all accessible projects and then list tasks for each one. The agent aggregates this data immediately, providing a single, consolidated report on task completion across all sites.

### Offboarding Assignments
An Operations Analyst realizes a key user left the company. They use the MCP to list organization users and then cross-reference that against project members to immediately identify every team member who needs their assignments reallocated or documented.

### Sprinting Quick Fix
A Developer Lead finishes a module for an internal audit. Instead of logging into Teambition, they tell their agent: 'Update the status of task X to Complete and assign it to QA.' The MCP handles the update_task action instantly.

### New Initiative Kickoff
A team needs a new workflow tracked. They ask their agent to get detailed info on 'New Feature Project,' which shows the existing project structure, allowing them to then use the MCP to create necessary sub-tasks and group them correctly.

## Benefits

- Stop manually checking project statuses. Ask your agent to list all accessible projects, getting an instant summary of what's active without opening the web interface.
- Task management gets fast. Instead of navigating deep into workflows, simply tell your agent to create a new task and specify its title, assignee, and due date.
- Team coordination becomes simple. You can ask the MCP to list project members or organization users, giving you immediate access to who is available for assignments.
- Workflow visualization is instant. Need to know what stages a project uses? Your agent lists all task groups and shows every stage inside them.
- Updates happen in seconds. Use the tool to update an existing task's status directly from your chat, logging the change without any clicks.
- Organization context is clear. Get high-level info about the entire organization structure or retrieve detailed data on a single project at a glance.

## How It Works

The bottom line is you talk to your agent instead of clicking through dashboards.

1. Subscribe to this MCP using your desired AI client.
2. Enter your specific Teambition App ID and App Secret credentials into the Vinkius catalog.
3. Ask your agent a task, like 'List all projects for the Website Redesign,' and it performs the action in real time.

## Frequently Asked Questions

**How do I use Teambition MCP to get a list of all my projects?**
You simply prompt your agent with an instruction like 'List all accessible projects.' The MCP uses the list_projects tool to fetch every project name and ID, giving you a full overview immediately.

**Can I use Teambition MCP to change a task's status?**
Yes. You tell your agent which task needs updating (using update_task), specify the new status, and it handles modifying the record in Teambition for you.

**Does Teambition MCP only show me tasks assigned to me?**
No. You can ask the agent to list tasks within an entire project (list_tasks), allowing you to see everything, regardless of who the assignee is.

**What if I need information about people on a project?**
You use the list_members tool. Just name the project and ask for the members, and your agent retrieves the full roster assigned to that specific workflow.