# Family Calendar Days AI Agent Connect

> Family Calendar Days MCP lets your AI client dig into the temporal details of your family schedule. Instead of just reading a list of events, your agent can calculate how many days you spend on specific activities, find where schedules clash, and measure how busy your weeks actually are.

## Overview
- **Category:** productivity
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_bobP9OLHNtnOxe9H3l2D0rKJ2NYI8UC4cbdqmYnc/ai-agent-connect
- **Tags:** calendar, analysis, family, scheduling, time-management

## Description

Managing a family schedule is usually about looking at what's happening next, but it's hard to see the bigger picture. This MCP changes that by letting your AI client treat your calendar as a data set. You can move past simple scheduling and start analyzing how your time is actually distributed. 

If you want to know if you're spending too much time on work versus family time, or if your vacations are actually long enough to feel like a break, your agent can pull those numbers for you. It can spot overlapping commitments that might cause friction and calculate the density of your busy periods. It's about turning a messy list of appointments into actionable insights about your family's rhythm.

## Tools

### count_category_days
This tool counts how many days are dedicated to a specific activity type. It helps you see exactly how much time is allocated to categories like vacations or school.

### find_overlapping_events
This tool identifies specific periods where multiple events are happening at the same time. Use it to catch scheduling conflicts before they cause problems.

### get_activity_density
This tool measures how busy a calendar is by comparing active days to the total time span. It gives your agent a way to quantify how packed your schedule feels.

### get_calendar_summary
This tool provides a high-level overview of the calendar's temporal footprint. It's the quickest way to see the total span and active days in a single view.

## Prompt Examples

**Prompt:** 
```
Give me a summary of the calendar with ID 'fam-123'.
```

**Response:** 
```
The calendar 'fam-123' spans 30 days in total, with 12 unique active days and 5 total events recorded.
```

**Prompt:** 
```
How many days are dedicated to 'Vacation' in calendar 'fam-123'?
```

**Response:** 
```
There are 7 total days and 7 unique active days dedicated to the 'Vacation' category in this calendar.
```

**Prompt:** 
```
Are there any overlapping events in calendar 'fam-123'?
```

**Response:** 
```
Yes, there is an overlap on 2024-07-04 involving event IDs 'evt-001' and 'evt-002'.
```

## Capabilities

### Activity Tracking
Your agent uses this to tally up days spent on specific categories like hobbies or trips.

### Conflict Detection
Your agent identifies when two or more events are scheduled for the same time.

### Schedule Density Analysis
Your agent compares active days against the total timeframe to see how crowded the schedule is.

### Temporal Footprint Summaries
Your agent pulls a quick overview of the total duration and active days in a calendar.

## Use Cases

### Vacation Planning
Check how many days are actually dedicated to a trip to ensure it's long enough.

### Conflict Resolution
Ask your agent to find where two family members have overlapping commitments.

### Time Budgeting
See if you are spending too many days on certain activities compared to others.

### Busy Week Alerts
Use activity density to see which weeks are going to be the most packed.

## Benefits

- Quantifies time spent on specific activities through category counting.
- Identifies scheduling conflicts by finding overlapping event periods.
- Measures schedule intensity by comparing active days to the total span.
- Provides high-level temporal summaries of calendar footprints.

## How It Works

You connect the MCP to your client and start asking questions about your calendar data.

1. Connect your preferred MCP-compatible client to Vinkius.
2. Provide your agent with the calendar ID you want to analyze.
3. Ask your agent to perform specific calculations like counting days or finding overlaps.
4. Receive direct, data-driven answers from your agent based on the MCP tools.

## Frequently Asked Questions

**What can this MCP do with my calendar?**
It analyzes the time-based properties of your calendar, such as how many days you spend on certain activities, where events overlap, and how busy your schedule is.

**Which AI clients can I use with this MCP?**
You can use this MCP with any compatible client, including Claude, Cursor, Windsurf, and VS Code.

**How does it identify overlapping events?**
The find_overlapping_events tool looks for periods where multiple events are occurring at the same time and reports those specific instances.

**Can I see how much time I spend on vacations?**
Yes, you can use the count_category_days tool to find exactly how many days are dedicated to a specific category like 'Vacation'.

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

**How does the tool handle overlapping events?**
The `get_calendar_summary` tool counts unique active days, meaning if two events overlap on the same date, that date is only counted once in the active day total.

**Can I filter by specific event types?**
Yes, you can use `count_category_days` to determine the total and unique active days for any specific category like 'Vacation' or 'School Holiday'.

**What is activity density?**
Activity density is a score calculated by the `get_activity_density` tool, representing the ratio of active days to the total number of days in a given timeframe.
