# Calendar Free Time MCP for scheduling. AI Agent Connect

> Calendar Free Time MCP lets your AI agent analyze your schedule to find open windows and measure how much free time you actually have. Instead of manually scanning your calendar, you can ask your agent to find specific gaps, check if a new meeting fits, or even calculate how fragmented your day is. It turns your messy calendar into actionable data for your AI client.

## Overview
- **Category:** productivity
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_70Lkic3ZgDqlCH5dlpee0WfwuSGBSS71BuY2RmB1/ai-agent-connect
- **Tags:** calendar, availability, scheduling, time-tracking, productivity

## Description

Stop squinting at your calendar to find a gap for a quick call. This MCP gives your AI client the ability to look at your scheduled commitments and tell you exactly when you are free. You can use it to get a high-level view of your total availability during work hours or drill down into specific time slots. If you are trying to squeeze in a new task, your agent can verify if the timing works without you having to cross-reference every single meeting. It also helps you understand the quality of your time by measuring how much your schedule is broken up by small, unusable gaps. It is a direct way to give your agent a real sense of your time constraints.

## Tools

### calculate_fragmentation_index
This tool measures how interrupted your free time is. It helps you see if your gaps are large enough to actually get work done.

### check_slot_availability
This tool checks if a specific time window is open. Use it to see if a new meeting or task fits into your current schedule.

### get_availability_summary
This tool provides a total count of your free time. It tells you exactly how many hours or minutes you have available within a set period.

### list_free_time_slots
This tool identifies every specific window of available time. It lists the exact start and end times for your open slots.

## Prompt Examples

**Prompt:** 
```
How much total free time do I have between 9:00 AM and 5:00 PM if I have a meeting from 10:00 AM to 11:00 AM?
```

**Response:** 
```
You have 7 hours (420 minutes) of total free time available.
```

**Prompt:** 
```
When are my available windows between 1:00 PM and 4:00 PM if I am busy from 2:00 PM to 2:30 PM?
```

**Response:** 
```
Your available windows are 1:00 PM to 2:00 PM and 2:30 PM to 4:00 PM.
```

**Prompt:** 
```
Can I fit a 45-minute meeting from 3:00 PM to 3:45 PM into my schedule?
```

**Response:** 
```
Yes, that time slot is available.
```

## Capabilities

### Total Time Calculation
Your agent sums up all available minutes within a specific range.

### Gap Identification
The AI finds the exact start and end times for every open window.

### Slot Verification
Your agent checks if a specific duration fits between existing meetings.

### Schedule Fragmentation Analysis
The AI calculates how much your free time is split into small pieces.

## Use Cases

### Finding Deep Work Blocks
Ask your agent to find a single continuous two-hour window in your afternoon.

### Quick Meeting Checks
Check if a client's requested time slot is actually open on your calendar.

### Daily Capacity Planning
Get a summary of your total available hours to plan your workload.

### Assessing Schedule Quality
Use the fragmentation index to see if your day is too broken up for productive work.

## Benefits

- Calculates total free minutes without manual math.
- Identifies specific time windows for new appointments.
- Measures how much your schedule interrupts your focus.
- Verifies meeting feasibility instantly.

## How It Works

Connect your client to Vinkius and start asking questions about your time.

1. Connect your preferred MCP-compatible client to Vinkius.
2. Grant the MCP access to your calendar data.
3. Ask your AI agent a question about your availability.
4. The agent uses the specific tools to calculate and return the answer.

## Frequently Asked Questions

**How does this MCP work with my AI client?**
You connect your client to Vinkius once. From then on, your agent can use the tools in this MCP to read your schedule and answer questions.

**Can I use this with Claude or Cursor?**
Yes, this MCP works with any MCP-compatible client, including Claude, Cursor, and Windsurf.

**What can the agent do with my calendar?**
The agent can find free time slots, calculate total availability, check if specific meetings fit, and measure schedule fragmentation.

**Do I need to set up my own hosting?**
No, Vinkius hosts and manages the MCP for you. You just connect and use it.

**Can it tell me if my day is too busy?**
Yes, by using the fragmentation index tool, your agent can tell you how interrupted your free time is.

**How do I know if a meeting fits in my schedule?**
You can use the `check_slot_availability` tool to verify if a specific time range is available within your defined availability period.

**Can I see my exact free time slots?**
Yes, the `list_free_time_slots` tool returns a list of all continuous available windows between your scheduled commitments.

**How much total free time is left in my day?**
The `get_availability_summary` tool calculates the total minutes of free time remaining within your active hours.