# task-duration-total is a time analysis MCP. AI Agent Connect

> task-duration-total gives your AI client the ability to crunch numbers on task time. It calculates total durations for specific task groups, sums up time by category, and provides statistical density metrics to show how work is distributed across your entire system.

## Overview
- **Category:** productivity
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_w6nEkTM0gulqmRsSvDwQx2xjxfgaYEOlzXNhZrJT/ai-agent-connect
- **Tags:** time, duration, aggregation, workload, metrics

## Description

You can stop manually adding up hours to figure out where your time went. This MCP acts as a calculation engine that your agent uses to pull specific time data from your task records. If you need to know the total time spent on a specific group of tasks, your AI client can pull that number instantly. You can also look at how much time is being swallowed by specific categories or get a high-level view of your entire workload. It even provides density metrics, which helps you see if your time is being spread too thin or concentrated in certain areas. Instead of staring at a spreadsheet, you just ask your agent for the totals and let it do the math.

## Tools

### get_category_duration
This tool sums up the time spent on every task within a specific category.

### get_task_density_metrics
This tool provides analytical insights into how time is distributed across your tasks.

### get_total_duration
This tool calculates the total time for a specific subset of tasks you choose.

### get_workload_summary
This tool returns a high-level overview of the total time and task counts in your system.

## Prompt Examples

**Prompt:** 
```
What is the total time spent on tasks T1, T2, and T3?
```

**Response:** 
```
The total duration for tasks T1, T2, and T3 is 3600 seconds.
```

**Prompt:** 
```
How much time has been spent on the 'development' category?
```

**Response:** 
```
The total time spent in the development category is 15400 seconds.
```

**Prompt:** 
```
Give me a summary of the total workload in the system.
```

**Response:** 
```
The system currently has a total workload of 85000 seconds across 42 registered tasks.
```

## Capabilities

### Subset Calculations
Your agent calculates the exact time spent on a specific list of tasks.

### Category Aggregation
The AI sums up durations for any specific category you define.

### Workload Overviews
Your agent pulls a high-level summary of all registered tasks and total time.

### Distribution Analysis
The AI uses density metrics to show how time is spread across your workload.

## Use Cases

### Budget Tracking
Your agent sums up durations for a specific category to see if a project is staying within its time limits.

### Capacity Planning
You use the workload summary to check how many tasks are active and how much total time they represent.

### Efficiency Audits
The AI uses density metrics to show if certain tasks are taking disproportionately long compared to others.

### Client Reporting
You pull the total duration for a specific subset of tasks to provide exact numbers to a client.

## Benefits

- Eliminates manual math for task duration totals.
- Provides instant visibility into category-specific time spend.
- Identifies workload imbalances through density metrics.
- Gives a bird's eye view of total system workload.

## How It Works

Connecting this MCP to your AI client gives it immediate access to your task data math.

1. Connect the MCP to your client like Claude or Cursor via Vinkius.
2. Ask your agent a question about task time or workload.
3. The agent calls the specific tool needed to pull the data.
4. The MCP performs the calculation and returns the result.
5. Your agent presents the final numbers to you.

## Frequently Asked Questions

**How do I use this MCP with Claude?**
You connect to the MCP through the Vinkius platform, which makes it instantly available to your Claude client.

**Can I calculate time for just one category?**
Yes, the get_category_duration tool is designed specifically to sum durations for a single category.

**What kind of workload data can I get?**
You can get a high-level summary of total time and task counts using the get_workload_summary tool.

**Does this MCP handle the math for me?**
Yes, it acts as a calculation engine that your agent uses to aggregate and sum task durations.

**Can I see how time is distributed?**
Yes, the get_task_density_metrics tool provides insights into how time is spread across your tasks.

**How can I find the total time spent on a specific group of tasks?**
You can use the `get_total_duration` tool by providing the list of task IDs you wish to sum.

**Can I see how much time is spent in a specific category?**
Yes, the `get_category_duration` tool allows you to aggregate all durations for any valid category name.

**What kind of statistical data can I get for my tasks?**
The `get_task_density_metrics` tool provides the average, maximum, and minimum durations, as well as the total duration for a set of tasks.