
Skylight Mcp
A comprehensive adapter for Skylight Calendar's family coordination platform, exposing 102 tools across events, shared lists, chores, rewards, meals, and albums. Handles headless OAuth2 authentication with email and password, then surfaces full read/write access to calendar operations (create, update, delete events with member assignment), chore scheduling (including recurring tasks via RRULE), reward tracking, and list management. Supports multi-frame accounts, webcal subscriptions, Apple Calendar linking, and AI-assisted meal planning with draft approval workflows. Particularly dense on frame configuration tools like member management, device settings, and notification preferences. Reaches for the same 2026-05-01 API version the mobile app uses, so you get feature parity without a browser.
- GitHub stars
- 23
- tools
- 80
- auth
- Secret needed
- transport
- STDIO
- env vars
- 11
- last updated
- Nov 11, 2026
Tools
80 toolsPublic tool metadata for what this MCP can expose to an agent.
skylight_list_framesList all frames on the account
List all frames on the account
No parameter schema in public metadata yet.
skylight_get_frameGet details for a specific frame
Get details for a specific frame
No parameter schema in public metadata yet.
skylight_list_frame_membersList members associated with a frame
List members associated with a frame
No parameter schema in public metadata yet.
skylight_list_devicesList physical devices linked to a frame
List physical devices linked to a frame
No parameter schema in public metadata yet.
skylight_get_plus_accessGet Skylight Plus subscription / entitlement status
Get Skylight Plus subscription / entitlement status
No parameter schema in public metadata yet.
skylight_get_reward_pointsGet reward-point balances per family member
Get reward-point balances per family member
No parameter schema in public metadata yet.
skylight_get_household_configGet household configuration for the frame
Get household configuration for the frame
No parameter schema in public metadata yet.
skylight_list_calendarsList the frame's calendar accounts and active calendars
List the frame's calendar accounts and active calendars
No parameter schema in public metadata yet.
skylight_get_event_notification_settingsGet the frame's calendar-event notification settings
Get the frame's calendar-event notification settings
No parameter schema in public metadata yet.
skylight_resolve_memberResolve a family-member name to its category id
Resolve a family-member name to its category id
No parameter schema in public metadata yet.
skylight_get_calendarGet one calendar account
Get one calendar account
No parameter schema in public metadata yet.
skylight_list_nudgesList nudges (reminders) in a date range
List nudges (reminders) in a date range
No parameter schema in public metadata yet.
skylight_update_frameUpdate frame display/sleep settings
Update frame display/sleep settings
No parameter schema in public metadata yet.
skylight_rename_frameRename a frame
Rename a frame
No parameter schema in public metadata yet.
skylight_update_profileUpdate the frame profile (name, birthday)
Update the frame profile (name, birthday)
No parameter schema in public metadata yet.
skylight_update_household_configUpdate household configuration
Update household configuration
No parameter schema in public metadata yet.
skylight_set_reminder_profileSet the global reminder cadence (interval_weeks)
Set the global reminder cadence (interval_weeks)
No parameter schema in public metadata yet.
skylight_add_webcalSubscribe the frame to a webcal/ICS calendar URL
Subscribe the frame to a webcal/ICS calendar URL
No parameter schema in public metadata yet.
skylight_update_calendarSet which sub-calendars of a connected account are active
Set which sub-calendars of a connected account are active
No parameter schema in public metadata yet.
skylight_delete_source_calendarRemove a connected source calendar (incl. webcal subscriptions)
Remove a connected source calendar (incl. webcal subscriptions)
No parameter schema in public metadata yet.
skylight_set_default_calendarSet the default source calendar for new events
Set the default source calendar for new events
No parameter schema in public metadata yet.
skylight_link_apple_calendarLink an Apple/iCloud calendar; the app-specific password comes from SKYLIGHT_APPLE_APP_PASSWORD, never a tool argument (confirm-gated)
Link an Apple/iCloud calendar; the app-specific password comes from SKYLIGHT_APPLE_APP_PASSWORD, never a tool argument (confirm-gated)
No parameter schema in public metadata yet.
skylight_categorize_source_calendarAttribute a source calendar's events to one or more family members
Attribute a source calendar's events to one or more family members
No parameter schema in public metadata yet.
skylight_create_source_calendarCreate a source calendar from raw provider attributes (advanced)
Create a source calendar from raw provider attributes (advanced)
No parameter schema in public metadata yet.
skylight_invite_userInvite a user to the frame by email (confirm-gated)
Invite a user to the frame by email (confirm-gated)
No parameter schema in public metadata yet.
skylight_approve_userApprove a pending frame user (confirm-gated)
Approve a pending frame user (confirm-gated)
No parameter schema in public metadata yet.
skylight_remove_userRemove a user from the frame (confirm-gated; the preview names the member)
Remove a user from the frame (confirm-gated; the preview names the member)
No parameter schema in public metadata yet.
skylight_delete_categoryDelete a category / family member (optional reassign_to_category_id, inferred; confirm-gated, the preview names the member)
Delete a category / family member (optional reassign_to_category_id, inferred; confirm-gated, the preview names the member)
No parameter schema in public metadata yet.
skylight_update_family_memberUpdate a family member's profile — birthday, dietary preferences (the name is the category label; set via skylight_update_category)
Update a family member's profile — birthday, dietary preferences (the name is the category label; set via skylight_update_category)
No parameter schema in public metadata yet.
skylight_update_categoryUpdate a category — rename/recolor, or convert a label into a family-member profile (linked_to_profile)
Update a category — rename/recolor, or convert a label into a family-member profile (linked_to_profile)
No parameter schema in public metadata yet.
skylight_create_categoryCreate a category / family member (optional linked_to_profile, avatar_id)
Create a category / family member (optional linked_to_profile, avatar_id)
No parameter schema in public metadata yet.
skylight_list_avatarsList the preset avatar library (emoji/icon images)
List the preset avatar library (emoji/icon images)
No parameter schema in public metadata yet.
skylight_set_member_avatarSet a family member's avatar to a custom photo (confirm-gated)
Set a family member's avatar to a custom photo (confirm-gated)
No parameter schema in public metadata yet.
skylight_set_device_albumSet which photo album a device displays (inferred)
Set which photo album a device displays (inferred)
No parameter schema in public metadata yet.
skylight_rename_deviceRename a Skylight device
Rename a Skylight device
No parameter schema in public metadata yet.
skylight_list_eventsList calendar events within a date range
List calendar events within a date range
No parameter schema in public metadata yet.
skylight_get_eventGet details for a specific event
Get details for a specific event
No parameter schema in public metadata yet.
skylight_create_eventCreate a new calendar event (optional category_ids assigns members; confirm-gated when invited_emails is set, the preview names every recipient)
Create a new calendar event (optional category_ids assigns members; confirm-gated when invited_emails is set, the preview names every recipient)
No parameter schema in public metadata yet.
skylight_update_eventUpdate an existing calendar event (optional category_ids assigns members; confirm-gated when invited_emails is set)
Update an existing calendar event (optional category_ids assigns members; confirm-gated when invited_emails is set)
No parameter schema in public metadata yet.
skylight_delete_eventDelete a calendar event
Delete a calendar event
No parameter schema in public metadata yet.
skylight_list_categoriesList event categories for a frame
List event categories for a frame
No parameter schema in public metadata yet.
skylight_list_source_calendarsList external source calendars linked to a frame
List external source calendars linked to a frame
No parameter schema in public metadata yet.
skylight_list_recent_invited_emailsList recently-invited email addresses
List recently-invited email addresses
No parameter schema in public metadata yet.
skylight_update_event_notification_settingsUpdate calendar-event notification settings
Update calendar-event notification settings
No parameter schema in public metadata yet.
skylight_list_listsList all shared lists on a frame
List all shared lists on a frame
No parameter schema in public metadata yet.
skylight_get_list_itemsGet items in a specific shared list
Get items in a specific shared list
No parameter schema in public metadata yet.
skylight_create_listCreate a new shared list (label + color + kind)
Create a new shared list (label + color + kind)
No parameter schema in public metadata yet.
skylight_update_listUpdate a list's name, color, or type
Update a list's name, color, or type
No parameter schema in public metadata yet.
skylight_delete_listDelete a shared list and its items (confirm-gated when the list has items; the preview lists them)
Delete a shared list and its items (confirm-gated when the list has items; the preview lists them)
No parameter schema in public metadata yet.
skylight_add_list_itemAdd an item to a shared list
Add an item to a shared list
No parameter schema in public metadata yet.
skylight_update_list_itemRename a list item, check/uncheck it, or set its section
Rename a list item, check/uncheck it, or set its section
No parameter schema in public metadata yet.
skylight_delete_list_itemDelete an item from a shared list
Delete an item from a shared list
No parameter schema in public metadata yet.
skylight_delete_list_itemsBulk-delete specific list items
Bulk-delete specific list items
No parameter schema in public metadata yet.
skylight_move_list_itemReorder a list item
Reorder a list item
No parameter schema in public metadata yet.
skylight_clear_listRemove all items from a list (single bulk delete; confirm-gated, the preview lists the items)
Remove all items from a list (single bulk delete; confirm-gated, the preview lists the items)
No parameter schema in public metadata yet.
skylight_set_list_item_sectionMove list items into a named section (or clear it)
Move list items into a named section (or clear it)
No parameter schema in public metadata yet.
skylight_list_choresList chores within a date range
List chores within a date range
No parameter schema in public metadata yet.
skylight_search_choresSearch chores (incl. unscheduled/template chores)
Search chores (incl. unscheduled/template chores)
No parameter schema in public metadata yet.
skylight_create_choreCreate a new chore (summary + category)
Create a new chore (summary + category)
No parameter schema in public metadata yet.
skylight_create_recurring_choreCreate a recurring chore or routine (RRULE)
Create a recurring chore or routine (RRULE)
No parameter schema in public metadata yet.
skylight_complete_choreMark a chore complete
Mark a chore complete
No parameter schema in public metadata yet.
skylight_uncomplete_choreReopen (un-complete) a chore
Reopen (un-complete) a chore
No parameter schema in public metadata yet.
skylight_update_choreUpdate a chore (supports recurrence + apply_to)
Update a chore (supports recurrence + apply_to)
No parameter schema in public metadata yet.
skylight_complete_chore_instanceMark a specific recurring-chore occurrence complete
Mark a specific recurring-chore occurrence complete
No parameter schema in public metadata yet.
skylight_delete_choreDelete a chore (occurrence or whole series via apply_to)
Delete a chore (occurrence or whole series via apply_to)
No parameter schema in public metadata yet.
skylight_list_rewardsList rewards configured for a frame
List rewards configured for a frame
No parameter schema in public metadata yet.
skylight_get_rewardGet one reward
Get one reward
No parameter schema in public metadata yet.
skylight_create_rewardCreate a reward (name + description + point_value + respawn_on_redemption + category_ids)
Create a reward (name + description + point_value + respawn_on_redemption + category_ids)
No parameter schema in public metadata yet.
skylight_update_rewardUpdate a reward
Update a reward
No parameter schema in public metadata yet.
skylight_delete_rewardDelete a reward
Delete a reward
No parameter schema in public metadata yet.
skylight_redeem_rewardRedeem a reward
Redeem a reward
No parameter schema in public metadata yet.
skylight_unredeem_rewardReverse a reward redemption
Reverse a reward redemption
No parameter schema in public metadata yet.
skylight_add_reward_pointsGrant or deduct reward points to members
Grant or deduct reward points to members
No parameter schema in public metadata yet.
skylight_list_mealsList planned meals in a date range (date_min + date_max both required)
List planned meals in a date range (date_min + date_max both required)
No parameter schema in public metadata yet.
skylight_list_recipesList meal recipes for the frame
List meal recipes for the frame
No parameter schema in public metadata yet.
skylight_list_meal_categoriesList meal categories for the frame
List meal categories for the frame
No parameter schema in public metadata yet.
skylight_get_recipeGet one meal recipe
Get one meal recipe
No parameter schema in public metadata yet.
skylight_create_recipeCreate a meal recipe (meal_category_id + summary)
Create a meal recipe (meal_category_id + summary)
No parameter schema in public metadata yet.
skylight_update_recipeUpdate a meal recipe
Update a meal recipe
No parameter schema in public metadata yet.
skylight_delete_recipeDelete a meal recipe
Delete a meal recipe
No parameter schema in public metadata yet.
Sponsors
Configuration
SKYLIGHT_REFRESH_TOKENsecretAn OAuth refresh token you already hold. Supply this and no password is needed — the login is skipped entirely.
SKYLIGHT_EMAILSkylight account email. Pair with SKYLIGHT_PASSWORD for direct login. Needed only if you are not supplying SKYLIGHT_REFRESH_TOKEN.
SKYLIGHT_PASSWORDsecretSkylight account password — required iff SKYLIGHT_EMAIL is set. Needed only if you are not supplying SKYLIGHT_REFRESH_TOKEN.
SKYLIGHT_FRAME_IDOptional: pick a specific Skylight frame when the account has more than one.
SKYLIGHT_NAMEFriendly account name used in startup logs.
SKYLIGHT_TOKEN_CACHESet to false to disable the on-disk token cache and re-authenticate on every process start. Defaults to enabled.
SKYLIGHT_TOKEN_FILEAbsolute path for the token cache file. Defaults to $MCP_DATA_DIR/.skylight-mcp/tokens.json.
SKYLIGHT_BASE_URLOverride the API base (default https://app.ourskylight.com/api). The auth origin is derived from it, so pointing this elsewhere moves the login flow too — and the new host must be added to the registration’s egress allowlist, or every call is blocked.
SKYLIGHT_APPLE_APP_PASSWORDsecretOptional: an app-specific password from appleid.apple.com, used only by skylight_link_apple_calendar. Env-only by design — the tool takes no password argument, so the credential never passes through the model or the transcript.
SKYLIGHT_APPLE_IDOptional: the Apple ID email skylight_link_apple_calendar links; the tool's email argument overrides it.
SKYLIGHT_UPLOAD_DIROptional: directories that the photo-upload, event-import-from-photo and avatar tools may read files from (several separated by ':', or ';' on Windows; '~' allowed). Any other path is refused. Unset: ~/Pictures and ~/Downloads, or only $MCP_DATA_DIR/uploads in a hosted deployment
Readme
skylight-mcp
MCP server for Skylight Calendar — 116 tools across calendar events (read+write), shared lists (read+write), chores and rewards (read+write), task-box items (read+write), meals (read+write), AI auto-creation (meal-plan + activity-idea generators with draft review/approve), messages and albums (read+write), photo/video upload, and frame/device/account settings + calendar + member management (read+write, incl. preset and custom-photo avatars).
Every API request carries the skylight-api-version: 2026-05-01 header (matching the official mobile app); without it some features 422 with "API version does not support …".
MCP protocol support
Details
- Repository
- github.com/chrischall/skylight-mcp
- Category
- Productivity & Office
- Package
skylight-mcp- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active
More from chrischall
- Ofw Mcp15
- Redfin Mcp3
- Zola Mcp3
- Infinitecampus Mcp5
- Resy Mcp2
- Creditkarma Mcp1
- Gogcli Mcp Docs1
- Gogcli Mcp Sheets1
- Onehome Mcp1
- Setlist Mcp1
- Splitwise Mcp1
- Artsonia Mcp1
- Canvas Parent Mcp1
- Gogcli Mcp Classroom1
- Gogcli Mcp Drive1
- Gogcli Mcp Slides1
- Honeybook Mcp1
- Opentable Mcp1
- Compass Mcp
- Evite Mcp
- Gemini Mcp
- Hellofresh Mcp
- Homes Mcp
- Signupgenius Mcp