Skylight MCP Server

An MCP (Model Context Protocol) server for the Skylight Calendar API. Enables AI assistants like Claude to interact with your Skylight family calendar, chores, lists, and more.

Note: This is a maintained continuation of TheEagleByte/skylight-mcp. The original project appears unmaintained; this repo carries the project forward with ongoing updates and bug fixes. The full original commit history and authorship is preserved in git.

Features

• Calendar: Query calendar events (“What’s on my calendar today?”)
• Chores: View and create chores (“Add emptying dishwasher to chores”)
• Lists: View grocery and to-do lists (“What’s on the grocery list?”)
• Tasks: Add items to the task box (“Add XYZ to my task list”)
• Family: View family members and devices
• Rewards: Check reward points and available rewards

Quick Start

Installation

Option 1: Claude Desktop (.mcpb, easiest)

1. Download the latest skylight-mcp-.mcpb from the Releases page.
2. In Claude Desktop, open Settings → Extensions, click Advanced settings, find the Extension Developer section, and click Install Extension…. Select the downloaded .mcpb. (On macOS/Windows, double-clicking the .mcpb file may also trigger the installer.)
3. Fill in your Skylight email, password, frame ID, and timezone when prompted.
4. That’s it — the Skylight tools are available in Claude Desktop.

No Node.js install or config editing required. Credentials are stored securely by Claude Desktop.

Option 2: npm package

mcp.json:

{
  "mcpServers": {
    "skylight": {
      "command": "npx",
      "args": ["@rjhalvorson/skylight-mcp"],
      "env": {
        "SKYLIGHT_EMAIL": "[email protected]",
        "SKYLIGHT_PASSWORD": "your_password",
        "SKYLIGHT_FRAME_ID": "your_frame_id"
      }
    }
  }
}

Claude Code:

claude mcp add skylight npx @rjhalvorson/skylight-mcp \
  -e [email protected] \
  -e SKYLIGHT_PASSWORD=your_password \
  -e SKYLIGHT_FRAME_ID=your_frame_id

Option 3: From source

git clone https://github.com/rjhalvorson/skylight-mcp.git
cd skylight-mcp && npm install && npm run build

Then use in mcp.json:

{
  "mcpServers": {
    "skylight": {
      "command": "node",
      "args": ["/path/to/skylight-mcp/dist/index.js"],
      "env": {
        "SKYLIGHT_EMAIL": "[email protected]",
        "SKYLIGHT_PASSWORD": "your_password",
        "SKYLIGHT_FRAME_ID": "your_frame_id"
      }
    }
  }
}

Instructions for AI

Copy this into your AI’s custom instructions or system prompt:

You have access to the Skylight MCP server. Skylight is a smart family calendar display that shows calendars, chores, grocery lists, meals, and rewards. Use the Skylight tools to help manage family schedules and organization.