# Fantastical MCP > Fantastical manages all your calendars—Google, iCloud, Exchange, and more—from a single chat interface. Create events using simple natural language phrases like 'Lunch with Bob tomorrow at noon.' You can also manage booking links, propose meeting times to multiple people, or sync tasks right alongside your appointments. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** time-management, natural-language-processing, event-scheduling, task-management, calendar-sync, appointment-booking ## Description You connect Fantastical to any AI agent to take full control of your work schedule and calendar details. Instead of opening five different apps just to check availability, you talk to your agent, which handles the complexity across all your providers. It parses natural language so you can just say 'Schedule a follow-up with Sarah next week' and it figures out the time zone, the people, and the event details automatically. You get a single view of everything—your events, your tasks, even your available booking slots. This makes coordination easy. Through Vinkius, you connect once from any MCP-compatible client to manage all this data without ever leaving your chat window. ## Tools ### list_events Retrieves a list of all scheduled events that fall within specified start and end dates. ### get_event Retrieves all specific details about a single, known calendar event using its unique ID. ### create_event Builds a new calendar event by interpreting natural language input like 'Lunch with Bob tomorrow at noon'. ### update_event Modifies details like the title or time of an existing event across all connected calendar providers. ### delete_event Removes an existing event from the calendar permanently. ### list_calendars Lists all calendar services currently connected to and unified within Fantastical. ### list_openings Displays all active, shareable booking links or scheduling pages you have set up. ### get_opening Fetches the detailed information for a specified scheduling opening link. ### list_proposals Returns a list of meeting proposals, including suggested times and responses from attendees. ### create_reminder Creates a new task or reminder item that syncs with services like Apple Reminders or Todoist. ## Prompt Examples **Prompt:** ``` Create event: 'Deep Work session tomorrow from 9am to 11am' ``` **Response:** ``` Event created! I've added 'Deep Work session' to your calendar for tomorrow (March 31, 2026) from 9:00 AM to 11:00 AM. I used Fantastical's natural language engine to parse your request flawlessly. ``` **Prompt:** ``` List my events for this week ``` **Response:** ``` Retrieving your schedule... You have 8 events this week across your connected calendars. Highlights include 'Product Review' on Wednesday and a 'Team Lunch' on Friday. Would you like the full list? ``` **Prompt:** ``` What are my active scheduling Openings? ``` **Response:** ``` I found 2 active Openings: '15 Minute Coffee Chat' and '60 Minute Strategy Session'. I can provide the booking links for you to share. ``` ## Capabilities ### Schedule new appointments Create events by giving simple phrases like 'Meeting with John Friday at 3 PM' instead of filling out forms. ### View all connected calendars See a unified view that pulls every scheduled event from Google, iCloud, Exchange, and other connected accounts. ### Manage booking links List and handle shareable time slots so people can book meetings with you based on your real-time availability. ### Propose meeting times Suggest multiple specific time options to attendees and track their responses until everyone agrees on a final slot. ### Update existing events Change details like the location, title, or notes of an event across all linked calendar accounts at once. ### Create tasks and reminders Set up task-like items with due dates that sync seamlessly alongside your scheduled appointments. ## Use Cases ### Coordinating an internal team meeting A PM needs to schedule a 'Q3 Review' with three department heads. Instead of logging into each person's calendar and comparing availability, they just ask their agent to suggest times. The agent uses `list_proposals` and handles the coordination until everyone accepts the final time. ### Handling a new client booking A Sales Rep gets an inquiry for a strategy session. Instead of sending a manual link, they ask their agent to list all active Openings. The agent provides the correct link and confirms the 60-minute slot is available right now. ### Updating travel details mid-trip A user's flight changes, forcing a meeting update. They tell their agent: 'Change my London appointment to Thursday at 1 PM.' The agent uses the `update_event` tool and pushes the new time across all linked calendars. ### Quickly reviewing the week's commitments A manager logs in and needs an overview. They ask their agent to list events for the current week. The agent uses `list_events` and presents a unified, color-coded view of every commitment across all linked services. ## Benefits - Stop manually checking multiple apps. You can now use natural language to create events, letting your agent handle the time zone and formatting for every connected calendar. - Coordinate complex meetings by asking your agent to list proposals. It tracks suggested times and replies until a final slot is confirmed, eliminating back-and-forth email chains. - Manage booking links effortlessly. Use the `list_openings` tool to see all active scheduling pages, making it simple to give clients a link they can use immediately. - Keep your tasks synced with appointments by using the reminder tools. You can set up recurring task items right alongside your scheduled meetings, keeping everything in one place. - Maintain data integrity when things change. If a meeting location changes, you just tell your agent to update the event, and it pushes the change across every service like Google or Exchange. - Get a single source of truth. The MCP unifies all calendars—Google, iCloud, etc.—allowing you to view everything in one structural list, making auditing simple. ## How It Works The bottom line is, you get centralized calendar control without manually opening or switching between any of your individual service apps. 1. Subscribe to the Fantastical MCP, then enter your specific API key into your AI client. 2. Tell your agent what you need. For example: 'I need to book a deep work session next Tuesday afternoon.' 3. The agent sends the request via your MCP connection and returns confirmation that the event was successfully created across all linked calendars. ## Frequently Asked Questions **How do I use the create_event tool with different time zones?** You don't have to. Just state the meeting details naturally, like 'Meet next Friday at 2 PM.' The MCP uses Fantastical's advanced parsing engine to correctly interpret and schedule that event across all your linked time zones. **Can I list_calendars to see what services are connected?** Yes. Using `list_calendars` confirms which providers (Google, iCloud, etc.) are currently unified under the MCP, letting you audit your connection status at a glance. **What is the difference between list_events and list_openings?** There's a big difference. `list_events` shows fixed appointments on specific dates. `list_openings` shows your customizable booking links, which are designed for people to schedule time with you. **How do I update an event if the location changes?** Just tell your agent what changed: 'Update my Tuesday meeting. The location is now the new HQ address.' The `update_event` tool handles pushing that correction to every calendar provider. **What specific details does running list_proposals give me regarding attendee responses?** It returns proposal titles, suggested times, individual responses, and which slots were finalized. You get a full status of the meeting negotiation without having to check multiple email threads. **If I use create_event for a time that conflicts with an existing booking, what happens?** The MCP detects scheduling conflicts and alerts you instantly. Your agent can then suggest alternative times or help you modify the event to fit around your current commitments. **When I use create_reminder, how does it handle syncing between Todoist and Apple Reminders?** It ensures consistency by creating the reminder in both linked services. This guarantees that the task is visible across all platforms you've connected to via Fantastical. **If I run get_event, does it pull details from only one calendar or multiple providers?** It pulls event data from all your connected providers and presents them in a single view. You see the full picture of any scheduled item regardless of which account owns the booking. **Can my agent create events using natural language phrases like in the Fantastical app?** Yes. Use the 'create_event' tool. Fantastical's engine is designed to parse phrases like 'Lunch with Bob at 1pm next Tuesday'. The agent will transmit the string and return the structured event data flawlessly. **How do I see my available scheduling links (Openings) via chat?** Use the 'list_openings' tool. Your agent will retrieve all your active scheduling pages, providing the booking link URLs and duration settings so you can share them with others easily. **Can I suggest multiple meeting times to someone through the agent?** Absolutely. Use the 'list_proposals' tool to monitor existing suggestions. Fantastical Proposals allow you to offer several slots to attendees, and your agent can help you track their responses and finalize the event.