chrischall avatar

Skylight Mcp

chrischall/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 tools

Public 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_TOKENsecret

An OAuth refresh token you already hold. Supply this and no password is needed — the login is skipped entirely.

SKYLIGHT_EMAIL

Skylight account email. Pair with SKYLIGHT_PASSWORD for direct login. Needed only if you are not supplying SKYLIGHT_REFRESH_TOKEN.

SKYLIGHT_PASSWORDsecret

Skylight account password — required iff SKYLIGHT_EMAIL is set. Needed only if you are not supplying SKYLIGHT_REFRESH_TOKEN.

SKYLIGHT_FRAME_ID

Optional: pick a specific Skylight frame when the account has more than one.

SKYLIGHT_NAME

Friendly account name used in startup logs.

SKYLIGHT_TOKEN_CACHE

Set to false to disable the on-disk token cache and re-authenticate on every process start. Defaults to enabled.

SKYLIGHT_TOKEN_FILE

Absolute path for the token cache file. Defaults to $MCP_DATA_DIR/.skylight-mcp/tokens.json.

SKYLIGHT_BASE_URL

Override 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_PASSWORDsecret

Optional: 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_ID

Optional: the Apple ID email skylight_link_apple_calendar links; the tool's email argument overrides it.

SKYLIGHT_UPLOAD_DIR

Optional: 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

CI npm license

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


View the full README on GitHub

Details

Repository
github.com/chrischall/skylight-mcp
Category
Productivity & Office
Package
skylight-mcp
Transport
STDIO
Auth
Required
Registry
MCP registry, active

More from chrischall

Related Productivity & Office MCP servers

View all
1acedatacloud avatarSeedance by Ace Data Cloudacedatacloud/seedancemcpGenerate Seedance videos with Ace Data Cloud; retrieve the original task for finished video.21stars
2littlebearapps avatarOutlook Mcplittlebearapps/outlook-mcpMicrosoft Outlook MCP server — 20 tools for email, calendar, contacts, and settings via Graph API.21stars
3xt765 avatarMCP Document Readerxt765/mcp_documents_readerAn MCP enabled multi-format document reader supporting DOCX, PDF, TXT, and Excel files21stars
4halflifezyf2680 avatarMPM-Codinghalflifezyf2680/mpm-codingTool-first MCP: AST nav, impact/flow, task chains, memo/recall.17stars
5chrischall avatarOfw Mcpchrischall/ofw-mcpOurFamilyWizard co-parenting for Claude — messages, calendar, expenses, and journal15stars
6jhostinaleck avatarBrightspacejhostinaleck/brightspace-mcpD2L Brightspace MCP server: courses, grades, rubrics, feedback, course files, calendar. Multi-auth.15stars