# Clockwise MCP

> Clockwise manages complex scheduling by finding optimal meeting slots, tracking team availability across multiple members, and protecting focus time. Connect this MCP to your favorite AI client to stop wasting time in calendar apps, letting your agent handle the messy parts of planning so you can just get work done.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** calendar-automation, focus-time, team-availability, meeting-optimization, scheduling, time-management

## Description

Managing a modern schedule isn't about booking meetings; it's about finding pockets of uninterrupted deep work. This MCP lets your AI client take full control of those complex workflows. Instead of manually cross-referencing calendars, you ask your agent for the best time to meet with three people next week, and it figures out overlapping free slots automatically. You can also audit how much focus time you've actually logged, or tell your calendar to adjust itself when a critical meeting pops up. The entire system runs through Vinkius, letting you connect this capability to any MCP-compatible client right from the catalog. It handles everything from optimizing meeting blocks to giving you reports on where your time is actually going.

## Tools

### get_calendar_events
Retrieves a list of all scheduled calendar blocks for any given time range.

### get_focus_time
Extracts specific data detailing your active deep work limits and blocks.

### get_preferences
Retrieves your current settings for things like lunch breaks and preferred focus time blocks.

### update_preferences
Changes specific user configurations, like updating your deep work goal hours.

### get_team_availability
Calculates the exact free times across a specified group of team members.

### get_autopilot_status
Checks the current status of intelligent meeting moving logic.

### toggle_autopilot
Turns the intelligent meeting moving feature on or off for your schedule.

### get_meeting_analytics
Identifies historical data arrays related to meeting metadata, helping you see patterns in meetings.

### get_time_insights
Generates deep analytical reports on your overall focus time and calendar efficiency.

### get_current_user
Pulls the identity details for the account currently logged into Clockwise.

## Prompt Examples

**Prompt:** 
```
What is my team's availability for tomorrow? Emails: ['john@acme.com', 'sarah@acme.com']
```

**Response:** 
```
Analyzing availability... Both John and Sarah are free between 10:00 AM - 11:30 AM and 2:00 PM - 3:30 PM tomorrow. Would you like me to schedule a meeting in one of these slots?
```

**Prompt:** 
```
Show me my focus time insights for this month
```

**Response:** 
```
This month, you achieved 45 hours of deep work across 22 Focus Time blocks. Your calendar fragmentation decreased by 12% compared to last month. Great job!
```

**Prompt:** 
```
Set my focus time goal to 3 hours per day
```

**Response:** 
```
Preferences updated! Your focus time goal is now set to 3 hours per day. Clockwise Autopilot will begin adjusting your flexible meetings to meet this target.
```

## Capabilities

### Check team availability
Find overlapping free times across multiple people's calendars instantly.

### Audit focus time blocks
View and manage your dedicated deep work periods to ensure you have space for concentration.

### Adjust meeting schedules
Use Autopilot to automatically shift flexible meetings when conflicts arise, minimizing disruption.

### Review time reports
Get weekly or monthly data on your deep work achievements and calendar health.

### Update personal goals
Change things like meeting-free days, lunch breaks, or focus time targets directly.

## Use Cases

### Finding the perfect cross-department slot
A project manager needs to schedule an all-hands meeting with people in three different time zones. They ask their agent, and it uses `get_team_availability` to pinpoint a single 90-minute window that works for everyone without manual checking.

### Protecting deep work during crunch time
A developer needs three uninterrupted hours to finish a critical bug fix. They tell their agent to check `get_focus_time` and then use the MCP to block out the necessary hours on their calendar, preventing any unscheduled meetings.

### Understanding meeting bloat
An operations manager wants to prove that too many small meetings are killing productivity. They run `get_meeting_analytics` and see a quantifiable report showing the cost of context switching across the team last quarter.

## Benefits

- Protect Deep Work: Use `get_focus_time` to audit your current focus blocks, ensuring you always have time for uninterrupted deep work when the team needs it.
- Find Availability Fast: The `get_team_availability` tool eliminates guesswork. Just ask your agent for a meeting slot and get confirmed free windows across everyone's calendar.
- Automate Conflict Resolution: Toggle Autopilot using `toggle_autopilot`. When conflicts hit, the system intelligently moves flexible meetings so you don't have to manually reschedule anything.
- Analyze Time Waste: Review historical data with `get_meeting_analytics` and `get_time_insights`. You can finally prove exactly how much time is lost to meeting fragmentation.
- Control Your Calendar: Update your rules directly via `update_preferences`. Set your focus goals or block out lunch breaks without touching a single calendar tab.

## How It Works

The bottom line is, you talk to your AI client about your schedule, not the other way around.

1. Subscribe to this MCP and provide your Clockwise API key or OAuth token.
2. Connect the credential to your AI client (like Cursor or Claude).
3. Ask your agent a scheduling question, like 'Find 90 minutes next week when John, Sarah, and I are all free'.

## Frequently Asked Questions

**How do I find overlapping free slots with `get_team_availability`?**
You provide your agent with a list of emails and a date range. The tool calculates all the common open windows, telling you exactly when everyone is available.

**What does `get_focus_time` check for?**
`get_focus_time` pulls data on your dedicated deep work blocks, so you know if your calendar actually leaves room for uninterrupted thinking time.

**Can I automatically change meetings using `toggle_autopilot`?**
Yes. Calling `toggle_autopilot` activates the system that intelligently moves flexible events when conflicts happen, so you don't have to manually drag and drop things.

**What is the best way to check team availability? Use `get_team_availability`?**
Using `get_team_availability` is the most direct method. It immediately identifies shared free time, cutting out all the manual cross-checking and email back-and-forth.

**How do I verify which user account my team's schedule belongs to using `get_current_user`?**
It retrieves your root identity mappings. This confirms that your agent is reading data for the correct organization account before you perform any scheduling actions.

**Can `update_preferences` handle setting multiple types of rules at once?**
Yes, it accepts a full override payload. You can update meeting-free days, lunch breaks, and focus time goals in one command to provision your configuration.

**What kind of meeting metadata history can I get using `get_meeting_analytics`?**
It pulls precise arrays detailing historical meetings. You retrieve metrics on things like how often meetings are fragmented or the actual costs associated with context switching.

**Before running changes, how do I check the current state with `get_autopilot_status`?**
It provides the explicit structural state of Autopilot. This lets your agent confirm if automated meeting adjustments are currently active or paused before you proceed.

**Can my agent protect my Focus Time automatically?**
Yes. Use the 'update_preferences' tool to set your focus time goals. The Clockwise AI will then automatically identify and block space on your calendar, and your agent can monitor these blocks using the 'get_focus_time' tool.

**How do I find a common meeting time for several teammates?**
Provide your agent with a list of emails and a target date. The 'get_team_availability' tool will aggregate free windows across all specified calendars, allowing the agent to suggest the best time for everyone.

**Is Clockwise really shutting down in 2026?**
Yes, the Clockwise team is joining Salesforce, and the service is scheduled to sunset on March 27, 2026. Users are encouraged to migrate to alternative solutions like Reclaim.ai before this date.