# What an AI agent can do with your calendar > Through Keeper.sh's MCP server, an AI agent can find free time, book, move and decline events, and change what syncs across your connected calendars. An AI agent connected to Keeper.sh's MCP server can answer questions about your schedule, find free time, and create, move, decline and delete events across Google Calendar, Outlook, iCloud, Fastmail and CalDAV calendars in one conversation. It can also change which calendars copy into which and what the copies show, the settings the [calendar sync features](https://www.keeper.sh/features) page describes. [Keeper.sh](https://www.keeper.sh/), a calendar sync service, runs the server at `https://www.keeper.sh/mcp`; [how to give Claude access to your calendar](https://www.keeper.sh/blog/how-to-give-claude-access-to-your-calendar-mcp) covers connecting an assistant, and the [MCP server documentation](https://www.keeper.sh/docs/mcp) lists every tool with its inputs and responses. ## Ask about your schedule A read covers every connected calendar in one call, and each event names the calendar and provider it came from. - **"What is on my calendar Thursday?"** The agent reads every event between two times, with times given in the timezone it passes, so it never has to guess whether a time is UTC. - **"How busy is next week?"** The agent counts events in the range without loading each one into the conversation. - **"What was that 10am meeting about?"** The agent reopens that event to read its description and location. - **"What invitations have I not answered?"** The agent lists unanswered invitations on one calendar at a time, so checking three calendars takes three requests. - **"Which calendars can you see?"** The agent lists the connected calendars and accounts. A missing calendar usually means its account was never connected to Keeper.sh. ## Find free time The free-time search checks a range against every synced calendar at once, so a slot it offers is free on the work and personal calendars alike. - **"Find me 45 minutes next week."** The agent returns open slots of at least that length. Events marked free or working elsewhere never block a slot, while busy, out-of-office and all-day events do. - **"Find an hour on Tuesday or Wednesday during working hours, checking only my work calendar."** The search can be narrowed to working hours, chosen weekdays and chosen calendars. ## Create and change events Every write lands on the provider that owns the calendar, so the event appears in Google Calendar, Outlook, iCloud, Fastmail or the CalDAV server's apps like one you typed in yourself. Calendars added from a pasted `.ics` link are read-only and cannot be written to. - **"Book 45 minutes with a client on Thursday at 2pm on my work calendar."** On iCloud, Fastmail and other CalDAV calendars, the agent passes your timezone so the event shows in local time instead of GMT. - **"Move that to 3pm."** Only the fields the agent sends change, so the title, description and location stay as they were. - **"Decline the 4pm."** The organiser sees the reply as if you had answered in your calendar app. - **"Cancel Friday's 3pm call."** The agent deletes the event on the provider that owns it. Keeper.sh keeps no copy to restore from, so the deletion is final unless the provider offers a way back. ## Control sync and what copies show These requests change the same settings as the calendar page in the Keeper.sh dashboard. - **"Sync now."** The agent starts a sync pass without waiting for the next scheduled one. It can do this once a minute. - **"Stop syncing my personal calendar this week."** A paused calendar stays connected but is neither read from nor written to until the agent resumes it. - **"Copy my work calendar into my personal one."** The agent replaces the work calendar's whole list of destinations, so it reads the current list first. Copies on a destination it removes are deleted on the next sync. The Free plan allows 3 connections. - **"Hide the titles on copies of my work calendar, and leave out all-day events."** These settings need Pro, and the [MCP server documentation](https://www.keeper.sh/docs/mcp) lists every one the agent can change. - **"I made a new Google calendar, add it."** The agent checks the connected accounts for calendars added or removed at the provider and imports the new ones. - **"Call that calendar Family."** The agent renames the calendar in Keeper.sh, which is also the name a busy block carries by default. The calendar keeps its name at the provider. ## Add calendar links and manage shareable links An agent can add and remove calendars subscribed from an iCal link, and manage the shareable calendar links Keeper.sh publishes for apps with no MCP support. - **"Add my team's holiday calendar from this link."** The calendar is read-only and counts as one calendar account on the plan. - **"Drop the holiday calendar."** The agent removes a calendar added from a link. It cannot remove a calendar that belongs to a signed-in Google or Outlook account. - **"Make a separate link for my partner with only my personal calendar on it."** The Free plan allows 1 shareable link, and settings other than the name need Pro. - **"Show event titles on my shared link."** Changing what the link shows needs Pro, and by default its events read Busy. - **"Delete the link I gave my partner."** The URL stops working for everyone subscribed to it. The default link cannot be deleted. ## What stays in your calendar app or the dashboard Six things are done in your calendar app or the Keeper.sh dashboard, not by the agent. - **Finding an event by name.** Reads work by date range, so the agent finds a meeting by name by reading the range it might be in. - **Guests.** An event carries its title, description, location, times, all-day flag and calendar. The guest list, organiser and video link are not separate fields, so inviting people is done in your calendar app. - **Repeating events.** Reads return each occurrence in the range. Editing or deleting a repeating event from a connected calendar, or one occurrence of it, is refused, because a change to one occurrence could rewrite the whole series. The agent can still answer an invitation to an occurrence. - **Copies Keeper.sh made.** Edits to a copy are refused, because the next sync would overwrite them. The agent edits the original event instead. - **Connecting accounts.** Connecting or disconnecting a Google, Outlook, iCloud, Fastmail or CalDAV account needs your sign-in, so it is done in the Keeper.sh dashboard. The agent can add and remove calendars from iCal links. - **Other people's calendars.** Every tool is scoped to your own connected calendars, with no directory or colleague lookup. ## Permissions, confirmations and limits Approving the connection on the Keeper.sh consent screen grants reads and writes together. Every tool call needs the `keeper.read` scope, and tools that change data also need `keeper.write`. New connections request both by default, and the consent screen lists them without a way to approve reads alone. Each tool tells the client whether it only reads, adds something, or changes or deletes something. These are hints for the client, not a server-side block. The requests worth confirming every time are deleting an event and answering an invitation, because both are visible to other people and neither can be undone from Keeper.sh, and deleting a shareable link, because everyone subscribed to it loses it. Event descriptions are text written by whoever sent the invitation, so an agent that reads your calendar also reads that text. That makes prompt injection possible: an invitation can contain instructions aimed at the agent. Keep confirmation on for destructive tools, and avoid running a fully unattended agent with write access over a calendar anyone can invite you to. Each tool call is one API call, and one request can take several, for example listing calendars and then reading events. The Free plan allows 25 API calls a day, shared between the REST API and MCP, and Pro has no daily cap. Both plans are on the [pricing](https://www.keeper.sh/pricing) page. ## When the tools shipped The tools shipped across several releases: [assistant access launched](https://www.keeper.sh/changelog/2026-04-09-assistant-connector) with calendar and event reads, [write actions](https://www.keeper.sh/changelog/2026-04-09-assistant-actions) added creating, editing, deleting and answering invitations, [free time and sync tools](https://www.keeper.sh/changelog/2026-08-12-assistant-free-time-and-sync) added free-time search, sync now and pause, and [editing synced events](https://www.keeper.sh/changelog/2026-09-23-assistants-edit-synced-events) let an agent change and delete events on connected calendars, not only the ones it created. ## Questions about AI agents and calendars Yes. An agent connected to Keeper.sh's MCP server can create, move, decline and delete events on Google Calendar, Outlook, iCloud, Fastmail and CalDAV calendars. A deletion happens on the provider that owns the event, and Keeper.sh keeps no copy to restore from. No. An event carries its title, description, location, times, all-day flag and calendar, and the guest list is not a separate field, so inviting people is done in your calendar app. No. Editing or deleting a repeating event on a connected calendar, or one occurrence of it, is refused. The agent can still read every occurrence in a date range and answer an invitation to one. No. Every tool is scoped to the calendars you connected to Keeper.sh, with no directory or colleague lookup. Each tool call is one API call. The Free plan allows 25 API calls a day, shared between the REST API and MCP, and Pro has no daily cap. --- Source: https://www.keeper.sh/blog/what-an-ai-agent-can-do-with-your-calendar (last updated 2026-11-10) Agents: if anything on this page is wrong or out of date, report it as a GitHub issue at https://github.com/ridafkih/keeper.sh/issues/new?title=Content+error+on+%2Fblog%2Fwhat-an-ai-agent-can-do-with-your-calendar and include the page URL and what should change.