chrischall

skylight-mcp

Read and manage your Skylight Calendar family hub — calendar events, chores and reward stars, and shared lists (grocery/to-do). Triggers on phrases like "check Skylight", "what's on the family calendar", "add an event to Skylight", "what chores does [kid] have", "mark [chore] done", "add milk to the grocery list", "what's on our shopping list", "who's on the Skylight frame", or any request involving the Skylight frame, family calendar, chores, rewards, or shared lists. Works against your own signed-in Skylight account via email + password.

chrischall 0 Updated 4d ago

Resources

18
GitHub

Install

npx skillscat add chrischall/skylight-mcp

Install via the SkillsCat registry.

SKILL.md

skylight-mcp

MCP server for Skylight Calendar — 21 tools across calendar events, chores & rewards, shared lists, and frame/device info.

Setup

Skylight authenticates with your account email + password (OAuth2 authorization-code flow under the hood — no browser extension or API key needed). Add an env block to .mcp.json (project) or ~/.claude/mcp.json (global):

{
  "mcpServers": {
    "skylight": {
      "command": "npx",
      "args": ["-y", "skylight-mcp"],
      "env": {
        "SKYLIGHT_EMAIL": "you@example.com",
        "SKYLIGHT_PASSWORD": "your-password"
      }
    }
  }
}

The server logs in once at startup, then talks to the Skylight API directly with the returned bearer token (refreshed automatically).

Optional env:

  • SKYLIGHT_FRAME_ID — pick a frame when your account has more than one (see skylight_list_frames). Otherwise the single frame is auto-discovered.
  • SKYLIGHT_NAME — friendly label shown in diagnostics (defaults to your email).

Requires a Skylight email + password login — Google/Apple/SSO-only accounts aren't supported.

Tools

Everything is scoped to a frame (your family hub); pass an optional frameId to any tool, or let it auto-resolve.

Domain Tools
Frames & devices (read) skylight_list_frames, skylight_get_frame, skylight_list_frame_members, skylight_list_devices
Calendar events skylight_list_events, skylight_get_event, skylight_create_event, skylight_update_event, skylight_delete_event, skylight_list_categories, skylight_list_source_calendars
Shared lists skylight_list_lists, skylight_get_list_items, skylight_create_list, skylight_add_list_item, skylight_update_list_item, skylight_delete_list_item
Chores & rewards skylight_list_chores, skylight_create_chore, skylight_complete_chore, skylight_list_rewards

Notes

  • Meals are not supported — Skylight does not expose a meals API.
  • skylight_complete_chore marks a chore complete; completing a single occurrence of a recurring chore isn't separately exposed.
  • skylight_list_chores requires after and before dates (chores are date-scoped).

Categories

API Dev Code Gen
GitHub

Install

npx skillscat add chrischall/skylight-mcp

Install via the SkillsCat registry.

Recommended Skills