# Focus Minutes Total is a time-tracking MCP. AI Agent Connect

> Focus Minutes Total lets your AI client pull specific focus metrics and session logs. Instead of manually checking your productivity stats, you can ask your agent to calculate total focus time, find your average session length, or pull a full list of your recent sessions. It turns your raw focus data into actionable insights for your agent to analyze.

## Overview
- **Category:** productivity
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_zhddQ00iSfVu3wygbgCjzF3vJAIg5DyHQe5atPIw/ai-agent-connect
- **Tags:** focus, productivity, time-tracking, metrics, sessions

## Description

You can now give your AI agent a window into your productivity habits. This MCP connects your focus session data directly to your AI client, allowing it to perform math and data retrieval that would otherwise require manual exports. If you need to know how much deep work you've actually done, your agent can pull the total minutes spent in focus sessions or count how many sessions you've completed. It can also dig into the specifics by pulling individual session logs or calculating how long your sessions typically last. This is useful for anyone who wants their agent to help them understand their work patterns or summarize their productivity over a specific period. You don't need to copy and paste logs; just ask your agent to check the data for you.

## Tools

### get_session_count
This tool returns the total number of focus sessions you have completed. It helps your agent track your frequency of deep work.

### get_average_session_duration
This tool calculates the mean length of your focus sessions. Your agent uses it to find out how long you typically stay in the zone.

### get_total_focus_minutes
This tool retrieves the cumulative minutes you've spent in focus. You can also use a session ID pattern to filter the results.

### list_user_sessions
This tool pulls a full list of your individual focus sessions. It provides the raw logs your agent needs to see specific session details.

## Prompt Examples

**Prompt:** 
```
How many total minutes has user_123 spent in focus sessions?
```

**Response:** 
```
User user_123 has spent a total of 450 minutes in focus sessions.
```

**Prompt:** 
```
What is the average duration of focus sessions for user_456?
```

**Response:** 
```
The average focus session duration for user_456 is 25 minutes.
```

**Prompt:** 
```
How many focus sessions has user_789 completed?
```

**Response:** 
```
User user_789 has completed 12 focus sessions.
```

## Capabilities

### Time Aggregation
Your agent sums up total minutes spent in focus sessions.

### Session Counting
Your agent identifies the total number of completed focus sessions.

### Duration Analysis
Your agent calculates the average length of your focus periods.

### Log Retrieval
Your agent pulls specific session details from your history.

## Use Cases

### Weekly Productivity Summaries
Ask your agent to calculate your total focus minutes for the week to see if you hit your targets.

### Work Pattern Analysis
Have your agent check your average session duration to see if your focus spans are increasing or decreasing.

### Session Auditing
Use the agent to list all recent sessions to verify your deep work logs.

### Goal Tracking
Let your agent compare your current session count against a specific goal you set.

## Benefits

- Eliminates manual data entry by letting your agent read session logs directly.
- Provides instant math on focus duration and session frequency.
- Allows for filtered time tracking using session ID patterns.

## How It Works

Connecting this MCP to your AI client gives your agent immediate access to your focus data.

1. Connect the MCP to your preferred client like Claude or Cursor via Vinkius.
2. Ask your agent a question about your focus time or session counts.
3. The agent invokes the necessary tool to pull your data.
4. The agent processes the numbers and gives you a direct answer.

## Frequently Asked Questions

**How do I use Focus Minutes Total with Claude?**
You connect the MCP through the Vinkius platform. Once connected, Claude can use the tools to answer questions about your focus sessions.

**Can I filter my focus time by specific sessions?**
Yes. The get_total_focus_minutes tool allows you to filter results by a session ID pattern.

**What kind of data can my AI agent see?**
Your agent can see total focus minutes, session counts, average durations, and individual session logs.

**Do I need to host this myself?**
No. Vinkius hosts and manages the MCP for you, so it is ready to use as soon as you connect it.

**Is this compatible with Cursor?**
Yes. This MCP works with any MCP-compatible client, including Cursor and Windsurf.

**How can I see the total time a user has spent focusing?**
You can use the `get_total_focus_minutes` tool by providing the user's unique ID.

**Can I see a list of all individual sessions?**
Yes, the `list_user_sessions` tool returns an array of all session IDs and their durations for a specific user.

**How is the average session duration calculated?**
The `get_average_session_duration` tool calculates the mean by dividing the total focus minutes by the total number of sessions recorded.