skylight-mcp — Claude Code MCP server: what it does, how to install
Connects Skylight Calendar to AI agents for tracking household events, chores, rewards, and frame configurations through 114 tools.
claude mcp add --env SKYLIGHT_REFRESH_TOKEN=<SKYLIGHT_REFRESH_TOKEN> --env SKYLIGHT_EMAIL=<SKYLIGHT_EMAIL> --env SKYLIGHT_PASSWORD=<SKYLIGHT_PASSWORD> --env SKYLIGHT_FRAME_ID=<SKYLIGHT_FRAME_ID> --env SKYLIGHT_NAME=<SKYLIGHT_NAME> --transport stdio skylight-mcp -- npx -y skylight-mcpWhat skylight-mcp does
The server links MCP clients with Skylight Calendar over stdio using official TypeScript SDK v2 primitives. It provides 114 tools covering calendar entries, family member profiles, chore lists, meal ideas, and photo uploads. Every request to the backend includes the skylight-api-version: 2026-05-01 header to avoid version mismatch errors.
Authentication runs headlessly via SKYLIGHT_EMAIL and SKYLIGHT_PASSWORD using S256 PKCE, or through an existing SKYLIGHT_REFRESH_TOKEN. You do not need to configure credentials just to boot the process, because authentication triggers only on the first tool invocation. If your account contains more than one device, setting SKYLIGHT_FRAME_ID is required to route requests to the intended hub.
What it helps with
- sync calendar schedules and track family events
- assign household chores and monitor reward points
- subscribe the display to external webcal feeds
- update device sleep times and screen profiles
Example prompts for the agent
- "List all calendar events scheduled on the Skylight frame for tomorrow"
- "Check the current chore reward points balance for all family members"
- "Subscribe our frame to this webcal calendar link"
How to install skylight-mcp
Platform CLI
claude mcp add --env SKYLIGHT_REFRESH_TOKEN=<SKYLIGHT_REFRESH_TOKEN> --env SKYLIGHT_EMAIL=<SKYLIGHT_EMAIL> --env SKYLIGHT_PASSWORD=<SKYLIGHT_PASSWORD> --env SKYLIGHT_FRAME_ID=<SKYLIGHT_FRAME_ID> --env SKYLIGHT_NAME=<SKYLIGHT_NAME> --transport stdio skylight-mcp -- npx -y skylight-mcpReplace <…> with your own values. 6 more environment variables are in the server README
Platform CLI
codex mcp add skylight-mcp --env SKYLIGHT_REFRESH_TOKEN=<SKYLIGHT_REFRESH_TOKEN> --env SKYLIGHT_EMAIL=<SKYLIGHT_EMAIL> --env SKYLIGHT_PASSWORD=<SKYLIGHT_PASSWORD> --env SKYLIGHT_FRAME_ID=<SKYLIGHT_FRAME_ID> --env SKYLIGHT_NAME=<SKYLIGHT_NAME> -- npx -y skylight-mcpReplace <…> with your own values. 6 more environment variables are in the server README
Config file
{
"mcpServers": {
"skylight-mcp": {
"command": "npx",
"args": [
"-y",
"skylight-mcp"
],
"env": {
"SKYLIGHT_REFRESH_TOKEN": "<SKYLIGHT_REFRESH_TOKEN>",
"SKYLIGHT_EMAIL": "<SKYLIGHT_EMAIL>",
"SKYLIGHT_PASSWORD": "<SKYLIGHT_PASSWORD>",
"SKYLIGHT_FRAME_ID": "<SKYLIGHT_FRAME_ID>",
"SKYLIGHT_NAME": "<SKYLIGHT_NAME>"
}
}
}
}Replace <…> with your own values. 6 more environment variables are in the server README
Config file
{
"servers": {
"skylight-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"skylight-mcp"
],
"env": {
"SKYLIGHT_REFRESH_TOKEN": "<SKYLIGHT_REFRESH_TOKEN>",
"SKYLIGHT_EMAIL": "<SKYLIGHT_EMAIL>",
"SKYLIGHT_PASSWORD": "<SKYLIGHT_PASSWORD>",
"SKYLIGHT_FRAME_ID": "<SKYLIGHT_FRAME_ID>",
"SKYLIGHT_NAME": "<SKYLIGHT_NAME>"
}
}
}
}Replace <…> with your own values. 6 more environment variables are in the server README
Platform CLI
gemini mcp add -e SKYLIGHT_REFRESH_TOKEN=<SKYLIGHT_REFRESH_TOKEN> -e SKYLIGHT_EMAIL=<SKYLIGHT_EMAIL> -e SKYLIGHT_PASSWORD=<SKYLIGHT_PASSWORD> -e SKYLIGHT_FRAME_ID=<SKYLIGHT_FRAME_ID> -e SKYLIGHT_NAME=<SKYLIGHT_NAME> skylight-mcp npx -y skylight-mcpReplace <…> with your own values. 6 more environment variables are in the server README
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about skylight-mcp
How to install skylight-mcp in Claude Code?
Run `claude mcp add skylight-mcp -e SKYLIGHT_REFRESH_TOKEN=<SKYLIGHT_REFRESH_TOKEN> -e SKYLIGHT_PASSWORD=<SKYLIGHT_PASSWORD> -e SKYLIGHT_APPLE_APP_PASSWORD=<SKYLIGHT_APPLE_APP_PASSWORD> -- npx -y skylight-mcp`.
What does skylight-mcp do?
It gives AI assistants tool access to Skylight Calendar displays. Agents can inspect schedules, manage chore lists, configure members, and adjust device settings.
How does skylight-mcp target a specific frame?
The server automatically selects your frame when only one device exists. For accounts with multiple hubs, you must set the SKYLIGHT_FRAME_ID environment variable.
