# Clockify MCP for AI Agents MCP

> Clockify connects your time tracking and project management directly into your AI workflow. Use this MCP to list workspaces, track team hours, audit detailed time entries, and start or stop timers using natural conversation in any compatible client.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** time-tracking, timesheets, project-monitoring, team-productivity, work-hours, reporting

## Description

Use this MCP to take control of how you monitor work hours and manage projects without opening the Clockify dashboard. Instead of navigating through multiple tabs and generating reports manually, your AI client handles it all via chat commands. You can list every workspace you have access to or check out specific project details for a given client. Need an audit? Your agent pulls detailed time entry metadata, including descriptions and which projects they belong to. It's also simple to get real-time data; you can start or stop timers right from your chat interface to ensure accurate logging as work happens. When you connect this MCP through Vinkius, you gain a centralized way to handle all your team logistics—from listing all users in a workspace to quickly reviewing time entries for any individual worker.


## Tools

### add_new_time_entry
Records a new, manual time entry against your workspace.

### get_my_clockify_profile
Retrieves basic information about the user who authenticated with Clockify.

### list_workspace_clients
Lists every client account configured within a specified workspace.

### list_workspace_projects
Lists all active projects associated with a specific workspace.

### list_user_time_entries
Retrieves time entries for one user in a given workspace.

### list_workspace_users
Lists all users available within a specific workspace.

### list_clockify_workspaces
Retrieves a list of all workspaces the connected user has access to.

### stop_current_timer
Stops any timer that is currently running for a specific user.

## Prompt Examples

**Prompt:** 
```
Show me all the time entries John Doe has logged against the 'Website Redesign' project this month.
```

**Response:** 
```
**Time Audit: John Doe**

| Date | Project | Hours | Description |
| :--- | :--- | :--- | :--- |
| 6/1/24 | Website Redesign | 3.5 hrs | Frontend UI adjustments |
| 6/3/24 | Website Redesign | 1 hr | Reviewing copy edits |
| 6/5/24 | Website Redesign | 2 hrs | Backend API connection setup |

*Total time logged: 6.5 hours.*
```

**Prompt:** 
```
List all workspaces and tell me which ones are for client billing.
```

**Response:** 
```
**Found Workspaces:**

1. **Alpha Corp** (ID: 1234) - Billing Active ✅
2. **Internal Team** (ID: 5678) - Internal Use Only 🚫
3. **Beta Solutions** (ID: 9012) - Billing Active ✅

You can run more detailed reports on Alpha Corp and Beta Solutions.
```

**Prompt:** 
```
Stop my current timer for the database migration project.
```

**Response:** 
```
✅ Timer Stopped.
The active session, 'Database Migration,' was running from 10:00 AM to 11:25 AM. Total time logged: **1 hour and 25 minutes.** This has been successfully recorded against your current workspace.
```

## Capabilities

### Get an overview of available workspaces
List and retrieve details for every Clockify workspace you have access to.

### Monitor projects and client lists
Access and monitor all configured projects and clients within a specific workspace.

### View historical time logs
Retrieve detailed records of time entries for any user in your team, allowing you to audit past work periods.

### Control real-time timers
Start or stop a running timer directly from your chat interface for accurate logging.

### Manage user rosters
List all users and team members within a specific workspace to understand who is assigned where.

## Use Cases

### The end-of-day report dump
A Project Manager needs to send out a daily report summarizing hours for five key team members. Instead of logging into Clockify and running five separate reports, they ask their agent: 'What were the total billable hours for the dev team today?' The agent uses `list_user_time_entries` and gives them the compiled data instantly.

### Billing verification on the go
A Freelancer just finished a meeting. They don't want to forget to log time. They simply type: 'Start timer for Client X, Project Y.' The agent starts tracking and they can stop it later using `stop_current_timer` right from their chat.

### Client scope review
An Operations Team Lead needs to know if a specific client is set up in the system. They ask: 'Which clients are active in our main workspace?' The agent uses `list_workspace_clients` and returns the list instantly, avoiding manual dashboard checks.

### Understanding team capacity
An HR Admin needs to check if a new employee is assigned to a project. They ask: 'Who's on the Marketing Ops team?' The agent uses `list_workspace_users` and provides the roster, helping management plan resource allocation.

## Benefits

- You can instantly list all workspaces you need to track, eliminating the manual step of navigating through different company accounts.
- Need a full picture of who's working on what? Your agent pulls user rosters using `list_workspace_users` and tells you exactly which team members are assigned.
- Stop guessing about hours. Use the chat interface to start or stop timers instantly, logging time with `stop_current_timer` without opening a separate app.
- Audit past work easily. Instead of filtering spreadsheets, your agent pulls detailed history using `list_user_time_entries`, showing descriptions and project links for every entry.
- It lets you view all available projects via the `list_workspace_projects` tool, keeping everyone on the same page about what's billable.

## How It Works

The bottom line is, you tell your agent what you need—like 'Show me John Doe's hours for last week,' and it pulls the data immediately.

1. Subscribe to this MCP on Vinkius.
2. Enter your Clockify API Key (you find this in Settings > My Profile).
3. Start asking your AI client questions about your time and projects.

## Frequently Asked Questions

**How do I use the Clockify MCP to check my team's hours?**
You simply ask your agent for a summary of time entries. It pulls detailed records for specific users or entire teams, giving you an immediate audit of who worked on what and when.

**Can Clockify MCP help me log time while I'm talking to my AI client?**
Yes, absolutely. You can start and stop timers directly through conversation. This means your agent handles the clock tracking for you, ensuring accurate logging without needing a separate dashboard.

**What kind of projects and clients can I see using Clockify MCP?**
The MCP allows you to list all configured workspaces, projects, and clients. This gives you full visibility into the scope of work across your entire account structure.

**Is the Clockify MCP only for time tracking, or can it do more?**
It does much more than just track time. It lets you manage team logistics by listing all users and helps you audit historical data by retrieving detailed time entry metadata.

**If I'm a freelancer, is the Clockify MCP useful for billing?**
Yes. You can quickly log billable hours using the agent to track your work in real-time. It simplifies verifying and recording time without needing to open or navigate complex web dashboards.