Which integrations are available for this server?

Allows linking Apple/iCloud calendars to Skylight, enabling reading and writing of calendar events via the Skylight frame. Allows linking iCloud calendars to Skylight, enabling reading and writing of calendar events via the Skylight frame.

How do I use skylight-mcp?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@skylight-mcp what's on my calendar for today?" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

skylight-mcp

by chrischall

Overview Schema Related Servers Score Discussions

TypeScript

Remote

skylight-mcp

npm license

MCP server for Skylight Calendar — 102 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), and frame/device/account settings + calendar + member management (read+write).

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 …".

Auth

The server uses a headless email+password OAuth2 authorization-code flow — no SSO, no 2FA, no browser extension required. Credentials are always SKYLIGHT_EMAIL + SKYLIGHT_PASSWORD.

On first tool call, the server performs four steps against https://app.ourskylight.com:

GET /auth/session/new — fetch the Rails CSRF token and session cookie.
POST /auth/session — log in with email + password (must happen before OAuth authorize).
GET /oauth/authorize — receive the one-time authorization code via redirect.
POST /oauth/token — exchange the code for a bearer access_token + refresh_token (7-day expiry).

The client then refreshes the token proactively (~60 s before expiry) and reactively on any 401. No bot wall has been observed — the headless flow works directly from Node.

No env vars → clean start: if credentials are not set, the server still starts without error. Auth is deferred to the first tool call, so MCP hosts can complete install-time tool listing before credentials are configured.

Related MCP server: mail-cal-drive-mcp

Frame model

All data in Skylight is scoped to a frame (the family hub device). On first use the client auto-discovers the single frame on the account. If the account has more than one frame, set SKYLIGHT_FRAME_ID to the frame ID you want. Every tool that reads frame-scoped data accepts an optional frameId arg to override the default.

Tools

Module	Tool	R/W	Description
frames	`skylight_list_frames`	R	List all frames on the account
frames	`skylight_get_frame`	R	Get details for a specific frame
frames	`skylight_list_frame_members`	R	List members associated with a frame
frames	`skylight_list_devices`	R	List physical devices linked to a frame
frames	`skylight_get_plus_access`	R	Get Skylight Plus subscription / entitlement status
frames	`skylight_get_reward_points`	R	Get reward-point balances per family member
frames	`skylight_get_household_config`	R	Get household configuration for the frame
frames	`skylight_list_calendars`	R	List the frame's calendar accounts and active calendars
frames	`skylight_get_event_notification_settings`	R	Get the frame's calendar-event notification settings
frames	`skylight_resolve_member`	R	Resolve a family-member name to its category id
frames	`skylight_get_calendar`	R	Get one calendar account
frames	`skylight_list_nudges`	R	List nudges (reminders) in a date range
frames	`skylight_update_frame`	W	Update frame display/sleep settings
frames	`skylight_rename_frame`	W	Rename a frame
frames	`skylight_update_profile`	W	Update the frame profile (name, birthday)
frames	`skylight_update_household_config`	W	Update household configuration
frames	`skylight_set_reminder_profile`	W	Set the global reminder cadence (interval_weeks)
frames	`skylight_add_webcal`	W	Subscribe the frame to a webcal/ICS calendar URL
frames	`skylight_update_calendar`	W	Set which sub-calendars of a connected account are active
frames	`skylight_delete_source_calendar`	W	Remove a connected source calendar (incl. webcal subscriptions)
frames	`skylight_set_default_calendar`	W	Set the default source calendar for new events
frames	`skylight_link_apple_calendar`	W	Link an Apple/iCloud calendar using an app-specific password
frames	`skylight_categorize_source_calendar`	W	Attribute a source calendar's events to one or more family members
frames	`skylight_create_source_calendar`	W	Create a source calendar from raw provider attributes (advanced)
frames	`skylight_invite_user`	W	Invite a user to the frame by email
frames	`skylight_approve_user`	W	Approve a pending frame user
frames	`skylight_remove_user`	W	Remove a user from the frame
frames	`skylight_delete_category`	W	Delete a category / family member (optional `reassign_to_category_id`, inferred)
frames	`skylight_update_family_member`	W	Update a family member's profile — birthday, dietary preferences (the name is the category label; set via `skylight_update_category`)
frames	`skylight_update_category`	W	Update a category — rename/recolor, or convert a label into a family-member profile (`linked_to_profile`)
frames	`skylight_set_device_album`	W	Set which photo album a device displays (inferred)
frames	`skylight_rename_device`	W	Rename a Skylight device
events	`skylight_list_events`	R	List calendar events within a date range
events	`skylight_get_event`	R	Get details for a specific event
events	`skylight_create_event`	W	Create a new calendar event (optional `category_ids` assigns members)
events	`skylight_update_event`	W	Update an existing calendar event (optional `category_ids` assigns members)
events	`skylight_delete_event`	W	Delete a calendar event
events	`skylight_list_categories`	R	List event categories for a frame
events	`skylight_list_source_calendars`	R	List external source calendars linked to a frame
events	`skylight_list_recent_invited_emails`	R	List recently-invited email addresses
events	`skylight_update_event_notification_settings`	W	Update calendar-event notification settings
lists	`skylight_list_lists`	R	List all shared lists on a frame
lists	`skylight_get_list_items`	R	Get items in a specific shared list
lists	`skylight_create_list`	W	Create a new shared list (label + color + kind)
lists	`skylight_update_list`	W	Update a list's name, color, or type
lists	`skylight_delete_list`	W	Delete a shared list
lists	`skylight_add_list_item`	W	Add an item to a shared list
lists	`skylight_update_list_item`	W	Rename a list item, check/uncheck it, or set its section
lists	`skylight_delete_list_item`	W	Delete an item from a shared list
lists	`skylight_delete_list_items`	W	Bulk-delete specific list items
lists	`skylight_move_list_item`	W	Reorder a list item
lists	`skylight_clear_list`	W	Remove all items from a list (single bulk delete)
lists	`skylight_set_list_item_section`	W	Move list items into a named section (or clear it)
chores	`skylight_list_chores`	R	List chores within a date range
chores	`skylight_search_chores`	R	Search chores (incl. unscheduled/template chores)
chores	`skylight_create_chore`	W	Create a new chore (summary + category)
chores	`skylight_create_recurring_chore`	W	Create a recurring chore or routine (RRULE)
chores	`skylight_complete_chore`	W	Mark a chore complete
chores	`skylight_uncomplete_chore`	W	Reopen (un-complete) a chore
chores	`skylight_update_chore`	W	Update a chore (supports recurrence + `apply_to`)
chores	`skylight_complete_chore_instance`	W	Mark a specific recurring-chore occurrence complete
chores	`skylight_delete_chore`	W	Delete a chore (occurrence or whole series via `apply_to`)
chores	`skylight_list_rewards`	R	List rewards configured for a frame
rewards	`skylight_get_reward`	R	Get one reward
rewards	`skylight_create_reward`	W	Create a reward (name + description + point_value + respawn_on_redemption + category_ids)
rewards	`skylight_update_reward`	W	Update a reward
rewards	`skylight_delete_reward`	W	Delete a reward
rewards	`skylight_redeem_reward`	W	Redeem a reward
rewards	`skylight_unredeem_reward`	W	Reverse a reward redemption
rewards	`skylight_add_reward_points`	W	Grant or deduct reward points to members
meals	`skylight_list_recipes`	R	List meal recipes for the frame
meals	`skylight_list_meal_categories`	R	List meal categories for the frame
meals	`skylight_get_recipe`	R	Get one meal recipe
meals	`skylight_create_recipe`	W	Create a meal recipe (meal_category_id + summary)
meals	`skylight_update_recipe`	W	Update a meal recipe
meals	`skylight_delete_recipe`	W	Delete a meal recipe
meals	`skylight_add_recipe_to_grocery_list`	W	Add a recipe's ingredients to a grocery list
meals	`skylight_plan_meal`	W	Plan a meal on a date (optionally repeating, link a recipe, add to grocery list)
messages	`skylight_list_messages`	R	List messages posted to the frame
messages	`skylight_list_albums`	R	List photo albums on the frame
messages	`skylight_get_message`	R	Get one frame message
messages	`skylight_create_album`	W	Create a photo album
messages	`skylight_update_album`	W	Update a photo album (rename, hide from slideshow)
messages	`skylight_delete_album`	W	Delete a photo album
messages	`skylight_add_to_album`	W	Add messages/photos to albums
messages	`skylight_remove_from_album`	W	Remove messages/photos from albums
messages	`skylight_add_message_comment`	W	Comment on a frame message/photo
messages	`skylight_set_message_caption`	W	Set a message/photo caption
messages	`skylight_like_message`	W	Like a frame message/photo
messages	`skylight_unlike_message`	W	Remove a like from a message/photo
messages	`skylight_delete_message`	W	Delete a frame message/photo
messages	`skylight_delete_messages`	W	Bulk-delete messages/photos from the frame
tasks	`skylight_list_tasks`	R	List task-box items
tasks	`skylight_create_task`	W	Create a task-box item
tasks	`skylight_update_task`	W	Update a task-box item
tasks	`skylight_delete_task`	W	Delete a task-box item
ai	`skylight_generate_meal_plan`	W	Generate an AI meal plan for given dates (draft meal sittings — async)
ai	`skylight_generate_activity_ideas`	W	Generate AI activity/event ideas for a location + time range (draft events — async)
ai	`skylight_get_auto_creation_intent`	R	Get an AI auto-creation intent (status + draft results)
ai	`skylight_list_auto_creation_drafts`	R	List the events an AI intent drafted (review before approving)
ai	`skylight_approve_auto_creation`	W	Approve AI-drafted events into real calendar events
ai	`skylight_undo_auto_creation`	W	Undo/discard an AI auto-creation intent and its drafts

Configuration

Required

SKYLIGHT_EMAIL=you@example.com
SKYLIGHT_PASSWORD=your-password

Optional

Env var	Default	Purpose
`SKYLIGHT_FRAME_ID`	auto-discovered	Force a specific frame when the account has multiple
`SKYLIGHT_NAME`	(none)	Friendly label used in startup logs
`SKYLIGHT_BASE_URL`	`https://app.ourskylight.com/api`	Override the API base URL

Treat .env like a password file — it is gitignored, do not commit it.

Local dev

npm install
npm run build
npm test
npm run dev   # requires .env with credentials

Tests: vitest, 100% line/branch/function/statement coverage enforced. All tests are mocked — no network calls in CI.

Developed and maintained by AI (Claude). Use at your own discretion.

Install Server

license - permissive license

quality

maintenance

How are these scores calculated?

Maintenance

–Maintainers

2dResponse time

4dRelease cycle

11Releases (12mo)

Commit activity

Issues opened vs closed

Resources

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Related MCP Servers

Google-Workspace-MCP-Server
giuseppe-coco
A
license
-
quality
D
maintenance
MCP server that seamlessly interacts with your Google Calendar, Gmail, Drive and so on.
Last updated 2025-07-11
30
MIT
mail-cal-drive-mcp
Email Calendar Management Cloud Storage
rumbitopi
A
license
-
quality
D
maintenance
A self-hosted MCP server for managing email, calendar, and cloud storage across Microsoft 365, Google Workspace, and IMAP accounts, enabling natural language interaction through any MCP client.
Last updated 2026-04-19
1
MIT
orchard-mcp
Calendar Management Email File Systems
l22-io
A
license
-
quality
B
maintenance
MCP server for Apple Calendar, Mail, Reminders, and Files on macOS using native frameworks.
Last updated 2026-06-19
66
11
MIT
local-apple-data
File Systems Note Taking Email
BillyBunn
A
license
A
quality
C
maintenance
MCP server for privacy-gated local Apple data access including Mail, Messages, Notes, Calendar, Contacts, Photos, Reminders, Voice Memos, and iCloud Drive.
Last updated 2026-06-04
30
1
MIT

View all related MCP servers

Related MCP Connectors

CalendarMCP
Hosted Google Calendar MCP server for AI agents. No self-hosting or Google Cloud setup.
Zooza MCP Server
MCP server for Zooza — class scheduling, attendance, and booking for activity businesses.
Appcircle MCP
MCP server for Appcircle mobile CI/CD platform.

View all MCP Connectors

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/chrischall/skylight-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server

skylight-mcp

Auth

Frame model

Tools

Configuration

Required

Optional

Local dev

Maintenance

Resources

Looking for Admin?

Tools

Related MCP Servers

Google-Workspace-MCP-Server

mail-cal-drive-mcp

orchard-mcp

local-apple-data

Related MCP Connectors

Latest Blog Posts

MCP directory API