# Clockwise MCP MCP

> Clockwise automatically manages scheduling conflicts, protects deep work time, and finds mutual free slots across entire teams. Connect this MCP to let your agent handle complex calendar coordination so you don't have to.

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

## Description

This connector lets your agent take full control of your intelligent calendar workflows using natural conversation. Forget manually cross-referencing ten different calendars just to schedule a quick sync. You can ask it, 'When is the best time for John and Sarah next week?' and it figures out the overlap immediately.

Beyond simple scheduling, you can set rules for how your day runs. You can tell it exactly what your deep work goals are or audit all the focus blocks that were created by AI tools. If meetings start eating up your protected time, this MCP lets you monitor those gaps and even adjust them with a single prompt.

For operations teams, it's huge. Instead of just seeing *when* people are free, you can retrieve historical data on meeting fragmentation and context-switching costs. When you build complex automations that span multiple platforms, the entire process runs within Vinkius. This means your agent uses the zero-trust proxy for every call, keeping all credentials in transit but never storing them—so you only worry about getting work done.

## Tools

### get_autopilot_status
Checks if the intelligent system for moving meetings is currently active and what its status is.

### get_calendar_events
Retrieves all major blocks of scheduled events on your calendar.

### get_current_user
Identifies the primary account and user details linked to this workspace.

### get_focus_time
Extracts specific information about your protected time blocks dedicated to deep work.

### get_meeting_analytics
Gathers detailed records and data points about past meetings, helping spot patterns of fragmentation.

### get_preferences
Reads your current personal settings, like specific holidays or preferred lunch breaks.

### get_team_availability
Calculates and reports the absolute free time slots across a list of multiple team members.

### get_time_insights
Pulls structured data that resolves deep work achievements and overall calendar health over a period.

### toggle_autopilot
Switches the intelligent meeting moving feature on or off, permanently changing how flexible meetings are handled.

### update_preferences
Changes your personal scheduling settings and overall Clockwise configuration.

## 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

### Find Team Availability
Checks multiple people's calendars to instantly find shared free time slots.

### Manage Focus Time Blocks
Lists and verifies all protected deep work periods on your calendar.

### Automate Meeting Rescheduling
Toggles intelligent meeting adjustment to shift meetings into better slots based on goals.

### Analyze Time Loss
Generates reports detailing how much time is lost to constant context switching and too many meetings.

### Update Scheduling Rules
Changes personal preferences like meeting-free days or specific focus goals instantly.

## Use Cases

### Setting up a quarterly review meeting
An agent checks the availability of five key stakeholders using `get_team_availability`. It finds that everyone is free Tuesday morning, and then schedules the meeting. No manual email coordination needed.

### Needing to prove deep work time was lost
An ops manager uses `get_time_insights` to pull a report showing calendar health for Q2. The data proves that high meeting frequency led to a 15% drop in focused output.

### Rescheduling after a major project shift
A team lead realizes the current schedule is too packed. They call `toggle_autopilot` and ask the agent to start adjusting flexible meetings immediately to balance the load.

### Blocking time for personal projects
You use `get_preferences` to confirm your meeting-free days, then instruct the agent to ensure no one schedules anything during those protected blocks.

## Benefits

- Stop guessing when people are free. Use the `get_team_availability` tool to check overlapping gaps across your entire team in seconds.
- Protecting focus time is easy. The MCP lets you audit existing Deep Work limits using `get_focus_time`, ensuring those crucial hours aren't accidentally booked over.
- Tired of calendar overload? You can monitor flexible events and use the `toggle_autopilot` tool to let your agent intelligently move meetings for better flow.
- Get actual data on wasted time. Run `get_meeting_analytics` to see how much your team loses to back-to-back, context-switching calls.
- Keep control of your schedule by using `update_preferences` whenever you need to set a new meeting-free day or adjust your daily focus goal.

## How It Works

The bottom line is: you talk to your agent, it talks to Clockwise, and you get back actionable calendar data without lifting a finger.

1. Subscribe to this MCP and enter your Clockwise API Key or OAuth Token.
2. Connect the MCP to your preferred client, like Claude or Cursor.
3. Ask your agent a question about scheduling, availability, or focus time.

## Frequently Asked Questions

**How does get_team_availability work with Clockwise?**
The `get_team_availability` tool checks multiple people's calendars simultaneously. It returns a clean list of mutual free windows, telling you exactly when the whole team is clear.

**What if I want to change my focus time goal? Use update_preferences.**
You use `update_preferences` and specify your new goal (e.g., '3 hours of deep work per day'). The system then adjusts the schedule accordingly.

**Can I check my historical meeting data with get_meeting_analytics?**
Yes, `get_meeting_analytics` retrieves detailed records on past meetings. This lets you track patterns like how often context switching is costing your team time.

**Does Clockwise MCP help me schedule a meeting without manual steps? Use get_calendar_events.**
It does. By referencing `get_calendar_events`, the agent knows all existing blocks, allowing it to find and propose new times automatically based on your instructions.

**How do I ensure my agent is checking availability for the correct account using get_current_user?**
It always uses your connected identity. This MCP confirms the root user ID before running any tool, so you don't have to worry about scope creep or incorrect accounts being used.

**If I need to pause automatic scheduling adjustments, how do I use toggle_autopilot?**
You simply call toggle_autopilot. This tool allows you to explicitly switch Autopilot on or off. It's essential for testing scenarios where you don't want the AI making irreversible meeting changes.

**Can I get detailed reports on deep work trends using get_time_insights?**
Yes, get_time_insights generates specialized structural arrays. It resolves nested focus analytics to give you a deeper view of your calendar health than general meeting histories allow.

**Before I update my rules, how can I check what my current constraints are using get_preferences?**
Use get_preferences. This tool retrieves a structural match of all explicit user settings. It's the best way to audit your existing meeting-free days or focus time goals before making any change.