MCP Server
appointment
io.github.theluckystrike/appointment
What this MCP does
Imports and reads ICS calendars, lists and searches events, finds conflicts and free time, and exports schedules.
Capabilities
Tools
12
tools
calendars_list
List imported calendars
List imported calendars: name, event-definition count, size, source, import time and free-tier use of the 2 slots. It also names stored .ics files with no calendar row. With none it prints the export steps.
Read only
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
conflicts
Find double bookings
Find double bookings: every PAIR of timed events that overlap, with the minutes they collide, across all calendars unless you name one. Whole-day events are reported apart. Free: 31 days. free_busy shows gaps.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['from', 'to'], 'properties': {'to': {'type': 'string', 'maxLength': 20, 'description': 'Last day, YYYY-MM-DD, included'}, 'from': {'type': 'string', 'maxLength': 20, 'description': 'First day, YYYY-MM-DD'}, 'calendar': {'type': 'string', 'maxLength': 80, 'description': 'One calendar name; default every imported calendar'}}, 'additionalProperties': False}
event_export
Export events to a .ics file
Call this tool to write chosen events to a new .ics file you can send or import elsewhere. Pass either ids (from events_list) or a from/to window. Times are written in UTC so the file lands correctly in any client.
Read only
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['out_path'], 'properties': {'to': {'type': 'string', 'maxLength': 20, 'description': 'Last day, YYYY-MM-DD, included'}, 'ids': {'type': 'array', 'items': {'type': 'string', 'maxLength': 200}, 'maxItems': 500, 'description': 'Event ids from events_list, events_search or next_event'}, 'from': {'type': 'string', 'maxLength': 20, 'description': 'First day, YYYY-MM-DD (alternative to ids)'}, 'calendar': {'type': 'string', 'maxLength': 80, 'description': 'With from/to: limit to one calendar'}, 'out_path': {'type': 'string', 'maxLength': 4096, 'description': 'Name for the downloaded .ics file, e.g. week.ics'}}, 'additionalProperties': False}
events_list
List events in a window
Every event between two dates, recurring expanded to occurrences, sorted by start. Times shown in your zone (profile's, else this machine's) unless zone passed. Each id works for event_export or event_to_time_entry.
Read only
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['from', 'to'], 'properties': {'to': {'type': 'string', 'maxLength': 20, 'description': 'Last day, YYYY-MM-DD, included'}, 'from': {'type': 'string', 'maxLength': 20, 'description': 'First day, YYYY-MM-DD'}, 'zone': {'type': 'string', 'maxLength': 100, 'description': 'Show local times in this zone or city instead of your own'}, 'calendar': {'type': 'string', 'maxLength': 80, 'description': 'One calendar name; default every imported calendar'}}, 'additionalProperties': False}
events_search
Search events
Find events whose title, description, location or attendees contain a phrase. Searches every imported calendar. Without from/to it looks a year back and a year forward on Pro, and the free window either side of today.
Read only
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['query'], 'properties': {'to': {'type': 'string', 'maxLength': 20, 'description': 'Last day, YYYY-MM-DD, included'}, 'from': {'type': 'string', 'maxLength': 20, 'description': 'First day, YYYY-MM-DD'}, 'query': {'type': 'string', 'maxLength': 200, 'description': 'Words to look for, case-insensitive'}}, 'additionalProperties': False}
event_to_time_entry
Turn a meeting into a time entry
Take one event and return the exact arguments for the time-tracker's entry_add, so a meeting that already happened becomes billable time without retyping it. Writes nothing: pass the JSON straight to entry_add.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['event_id', 'project'], 'properties': {'rate': {'anyOf': [{'type': 'number', 'minimum': 0}, {'type': 'string', 'maxLength': 60}], 'description': "Hourly rate for this entry; a number (120) or the words the user said ('120 euros an hour')"}, 'project': {'type': 'string', 'maxLength': 80, 'description': 'Project or client the meeting is billed to'}, 'currency': {'type': 'string', 'maxLength': 20, 'description': "Currency of the rate: EUR, USD, GBP, PLN, or the word the user said ('euros'). Without it the time-tracker falls back to USD."}, 'event_id': {'type': 'string', 'maxLength': 200, 'description': 'Event id from events_list, events_search or next_event'}}, 'additionalProperties': False}
free_busy
Busy blocks and free windows
Merged busy blocks and the free gaps inside your working hours over a day range. Events marked free do not count; whole-day events block the day. Free: 31 days. Use conflicts for overlapping pairs.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['from', 'to'], 'properties': {'to': {'type': 'string', 'maxLength': 20, 'description': 'Last day, YYYY-MM-DD, included'}, 'from': {'type': 'string', 'maxLength': 20, 'description': 'First day, YYYY-MM-DD'}, 'zone': {'type': 'string', 'maxLength': 100, 'description': 'Zone the working hours and the output are in; default your own'}, 'work_end': {'type': 'string', 'maxLength': 10, 'description': 'End of your working day, HH:MM, default 17:00'}, 'calendars': {'type': 'array', 'items': {'type': 'string', 'maxLength': 80}, 'maxItems': 20, 'description': 'Calendar names; default all of them'}, 'work_start': {'type': 'string', 'maxLength': 10, 'description': 'Start of your working day, HH:MM, default 09:00'}}, 'additionalProperties': False}
ics_forget
Forget a calendar
Remove one imported calendar by name and delete this server's local copy of its .ics, freeing a slot. Your own calendar and the source file are untouched. ics_import replaces a name in place.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['name'], 'properties': {'name': {'type': 'string', 'maxLength': 80, 'description': 'The calendar name from calendars_list'}}, 'additionalProperties': False}
ics_import
Import a calendar (.ics)
Call this tool to read a calendar export and keep it under a name. Give path (.ics file), text (contents), or url (public .ics/webcal feed; Pro). Google, Apple, Outlook exports read. Re-importing a name replaces it.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['name'], 'properties': {'url': {'type': 'string', 'maxLength': 4096, 'description': 'Public https:// or webcal:// .ics feed. Fetched once, only because you asked; Pro feature'}, 'name': {'type': 'string', 'maxLength': 80, 'description': 'What to call this calendar, e.g. "work" or "family"'}, 'path': {'type': 'string', 'maxLength': 4096, 'description': 'Not available on this hosted endpoint, which has no filesystem: paste the file as text instead'}, 'text': {'type': 'string', 'maxLength': 5242880, 'description': 'The .ics file contents, pasted'}}, 'additionalProperties': False}
license_activate
Activate license
Turn Pro on for this connection with key, an MCPL1.<payload>.<signature> issued at checkout for this server or the bundle. Data under your token stays; a wrong or expired key changes nothing. license_status confirms it.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['key'], 'properties': {'key': {'type': 'string', 'description': 'License key from checkout, MCPL1.<payload>.<signature>'}}, 'additionalProperties': False}
license_status
License status
Report this endpoint's licence state for your token as JSON: the product, the tier free or pro, why it is not Pro, and the checkout URL. Call it to explain a free-tier refusal. No arguments, nothing changes.
Read only
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
next_event
Next event
The first event not yet started, within the next 366 days, across every imported calendar or one you name. Returns title, times in your zone, how long until it starts, location, attendees and its id.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'calendar': {'type': 'string', 'maxLength': 80, 'description': 'One calendar name; default every imported calendar'}}, 'additionalProperties': False}
History
Recent tool changes
Added
ics_forget
Sept. 24, 2026, 2:40 a.m.
Added
event_to_time_entry
Sept. 24, 2026, 2:40 a.m.
Added
event_export
Sept. 24, 2026, 2:40 a.m.
Added
next_event
Sept. 24, 2026, 2:40 a.m.
Added
conflicts
Sept. 24, 2026, 2:40 a.m.
Added
free_busy
Sept. 24, 2026, 2:40 a.m.
Added
events_search
Sept. 24, 2026, 2:40 a.m.
Added
events_list
Sept. 24, 2026, 2:40 a.m.
Added
calendars_list
Sept. 24, 2026, 2:40 a.m.
Added
ics_import
Sept. 24, 2026, 2:40 a.m.
Added
license_activate
Sept. 24, 2026, 2:40 a.m.
Added
license_status
Sept. 24, 2026, 2:40 a.m.
Discover
Similar MCP servers
freedom-mcp
com.getfreedomos/freedom-mcp
Supports company operations through commitments, teams, agents, customer evidence, leads, content workflows, spreadsheets, commer…
Calcgrid
com.tttkmbb/calcgrid
Runs general-purpose calculators for loans, dates, lunar and solar terms, time zones, units, and a larger catalog of specialized …
Local MCP
com.local-mcp/local-mcp
Connects AI assistants to Mac email, calendars, reminders, notes, tasks, files, Microsoft 365, Todoist, spreadsheets, and daily b…
Stable Baseline
io.stablebaseline/sb
Manages company documents, knowledge graphs, whiteboards, projects, plans, tasks, teams, and improvement workflows.
hopi
uk.co.hopi/hopi
Provides read-only calculators, converters, validators, text utilities, encoders, and generators for everyday and technical tasks.
mu
mu.micro/mu
Supports personal and collaborative tasks including web browsing, app creation, blogs, bookmarks, discussions, and contact manage…
John's Essentials
com.johnsessentials/johns-essentials
Analyzes and converts documents, images, audio, video, archives, data files, and other media formats, with PDF chat and file insp…
Dayze — Life Context
com.dayze/life-context
Provides authenticated personal life-context data and tools for contacts, memories, events, expenses, trips, assets, places, and …