# Worksection MCP MCP

> Worksection MCP manages projects, tasks, and team time directly through your AI agent. It lets you list all active projects, create new tasks from conversation, stop running timers, and pull detailed logs of everything that happened in your workspace.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Tags:** task-management, time-tracking, project-collaboration, team-productivity, project-lifecycle

## Description

This connection gives your agent the ability to run complex project workflows inside Worksection. You don't have to click through multiple tabs or remember which API call handles a specific action—you just talk to it. Need an update on Project Alpha? Your agent can pull detailed project information, list all associated tasks, and even check who is working on it. If you need to adjust the timeline, your agent can stop active timers or fully complete overdue tasks using simple language commands.

For operational teams that track time and manage complex projects, visibility matters. Because this MCP runs on Vinkius, you get full oversight via Vinkius AI Analytics; you'll know exactly which tool was called and what data flowed through when your agent updates a task status or retrieves an activity log. This makes sure nothing happens in the dark. You connect once from any compatible client, giving your agent access to all these critical project functions.

## Tools

### complete_task
Marks a specific project task as finished in the system.

### create_task
Adds a brand new, empty task to a specified project.

### get_project_details
Fetches all current information about an entire workspace project.

### get_task_details
Retrieves every piece of data and comment associated with a single task.

### list_active_timers
Checks the list of all timers that are currently running for team members.

### list_all_users
Pulls a directory listing of every user account registered in the company.

### list_project_members
Lists all team members assigned to a specific project.

### list_project_tasks
Generates a list of every task belonging to a given project.

### list_projects
Shows all the main projects available in your entire workspace.

### list_work_history
Retrieves the full, chronological event log of activity across your account.

### reopen_task
Restores a task that was previously marked as complete or archived.

### stop_timer
Stops and records the time tracking for an active user timer.

## Prompt Examples

**Prompt:** 
```
List all my active project folders in Worksection.
```

**Response:** 
```
I've retrieved your projects. You have several active folders including 'Main Projects', 'Internal Tasks', and 'Client Work'. Which one would you like to explore?
```

**Prompt:** 
```
Show me the last 10 events from my account activity log.
```

**Response:** 
```
Fetching activity... Recent events include 'Task #123 completed by John', 'New comment on project Alpha', and 'Timer started by Sarah'.
```

## Capabilities

### Project Overview
Get a full list of available projects and pull detailed status reports on specific work areas.

### Task Lifecycle Control
Create new tasks, finish old ones, restore closed items, or get granular details about any task in the system.

### Time Tracking Management
Check which team members have active timers running and stop a timer when work is done.

### Team Coordination
List all users in the company, see who is assigned to a project, or review task comments for collaboration history.

### Activity Auditing
Retrieve an event log of recent account actions and view detailed activity across your entire workspace.

## Use Cases

### The End-of-Week Status Check
A PM needs to report on 15 projects. Instead of calling out to five different people, they ask their agent to run `list_projects`, then for each one, call `list_project_tasks` and pull the status using `get_task_details`. The AI compiles it all into a summary email.

### The Unexpected Project Delay
A team realizes a task was completed but needs to be reworked. They tell their agent, 'I need to fix Task 45.' The agent uses `get_task_details` and then runs `reopen_task`, making sure the work is visible again.

### The Time Accountability Check
An Operations Lead needs to know if John worked on Project Beta today. They ask their agent to run `list_active_timers` and then confirm that his timer was stopped by running `stop_timer`.

### Onboarding a New Team Member
A manager needs a quick overview of the team structure. They ask their agent to run `list_all_users`, and then use that list to check which users are assigned as members via `list_project_members` for the main client account.

## Benefits

- Stop manually checking status reports. Your agent can pull the entire list of projects and then run `list_project_tasks` to give you a unified overview.
- Never lose track of who’s doing what. Use `list_active_timers` to see who is currently clocked in, and use `stop_timer` when they wrap up for the day.
- Get immediate context on any work item. Instead of searching through dashboards, your agent runs `get_task_details` to pull every comment and file attached right away.
- Build a perfect audit trail. If you need to know what changed last week, calling `list_work_history` gives you the complete chronological record in one go.
- Manage team structure without logging into Worksection. You can use `list_all_users` and then check out all collaborators for a specific project using `list_project_members`.

## How It Works

The bottom line is you use plain conversation to execute complex administrative actions across your entire work team.

1. Subscribe to the Worksection MCP and provide your specific Account Name (subdomain) and Admin API Key.
2. Connect this MCP through a single session from any compatible AI client, like Cursor or Claude.
3. Ask your agent natural language questions, such as 'Show me all tasks for the Marketing project' or 'Stop Sarah’s timer.'

## Frequently Asked Questions

**How do I check who worked on a project using Worksection MCP?**
You can run `list_project_members` to see all assigned team members. You should also run `get_task_details` for specific tasks to view comment history and collaborator roles.

**Can I use Worksection MCP to manage time tracking?**
Yes, you can. Use the agent to check running timers with `list_active_timers`, and then run `stop_timer` when a team member finishes their work for the day.

**Does Worksection MCP allow me to list all company users?**
Yes. You can use the `list_all_users` tool to get a complete directory listing of every account in your workspace.

**How do I check what happened on my project recently using Worksection MCP?**
Run `list_work_history`. This fetches the full event log, letting you see exactly when tasks were completed or modified across the entire account.

**What information does the `create_task` tool require to add a new project task in Worksection MCP?**
You must provide the parent project ID and a title for any new task. You can also specify an initial assignee or due date when you call `create_task`. This ensures the task is properly placed within your existing project structure.

**If I need to revive a task, how does the `reopen_task` tool work with Worksection MCP?**
The `reopen_task` tool restores a task that was previously marked as complete or archived. You just need to provide the specific task ID you want to reactivate. This makes it instantly visible and actionable again.

**When I run `list_project_tasks`, what level of detail can I expect for every item within that project using Worksection MCP?**
The tool returns a list containing the task name, current status (e.g., 'In Progress', 'To Do'), and the assigned user ID. If you need more details on any single task, use `get_task_details` next.

**What project metadata can I retrieve about a specific workspace using the `get_project_details` tool?**
This MCP call pulls core information like the project's description, start date, and associated folder structure. It gives you an overview of the scope before listing individual tasks or members.