How do I install Skylight?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Skylight need an API key?

No required environment variable is listed on this record.

What transport does Skylight use?

Skylight runs locally over stdio.

When was Skylight last checked?

Last checked 2026-10-27. MCP server for Skylight family calendar - enables AI assistants to manage calendars, chores, lists, meals, and rewards

MCP-сервер Skylight

Усильте агента

Добавить этот сервер

Install from the publisher. Not a PlugMCP endpoint.

Запустить на PlugMCP

Host a copy with our keys and logs.

No packaged release in the registry yet. Follow the repository README.

RepositoryPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Запустить на PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Запуск

Server facts

Local

Transport: stdio
License: MIT
Last checked: 2026-10-27

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

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.

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: npm package (Recommended)

mcp.json:

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

Claude Code:

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

Option 2: From source

git clone https://github.com/TheEagleByte/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.

Tips:

Call get_family_members before assigning chores to get member names

Grocery items default to the main grocery list if no list specified

Dates accept "today", "tomorrow", day names, or YYYY-MM-DD format

Some tools (rewards, meals, photos) require Skylight Plus subscription

Prerequisites

Node.js 18+
A Skylight account with an active subscription
Your Skylight Frame ID (see Finding your Frame ID)

Authentication

The MCP server supports two authentication methods:

Option 1: Email/Password (Recommended)

Use your Skylight account credentials. The server will automatically log in and manage tokens.

[email protected]
SKYLIGHT_PASSWORD=your_password
SKYLIGHT_FRAME_ID=your_frame_id

Option 2: Manual Token (Legacy)

Capture a token from the Skylight app using a proxy tool.

SKYLIGHT_TOKEN=your_token_here
SKYLIGHT_FRAME_ID=your_frame_id
SKYLIGHT_AUTH_TYPE=bearer

Finding your Frame ID

You still need to find your frame ID (the household identifier):

Use a proxy tool (Proxyman, Charles, or mitmproxy)
Capture any API request from the Skylight app
Look at the URL path: /api/frames/{frameId}/...
Example: /api/frames/abc123/chores → frame ID is abc123

Configuration

Variable	Required	Description
`SKYLIGHT_EMAIL`	Option 1	Your Skylight account email
`SKYLIGHT_PASSWORD`	Option 1	Your Skylight account password
`SKYLIGHT_TOKEN`	Option 2	Your API token (if not using email/password)
`SKYLIGHT_AUTH_TYPE`	No	`bearer` (default) or `basic` (for manual token)
`SKYLIGHT_FRAME_ID`	Yes	Your household frame ID
`SKYLIGHT_TIMEZONE`	No	Default timezone (default: `America/New_York`)

Example .env file:

# Email/password auth (recommended)
[email protected]
SKYLIGHT_PASSWORD=your_password
SKYLIGHT_FRAME_ID=your_frame_id
SKYLIGHT_TIMEZONE=America/New_York

Available Tools

Calendar Tools

Tool	Description
`get_calendar_events`	Get calendar events for a date range
`get_source_calendars`	List connected calendar sources (Google, iCloud, etc.)

Chore Tools

Tool	Description
`get_chores`	Get chores with optional filters (date, assignee, status)
`create_chore`	Create a new chore with optional recurrence

List Tools

Tool	Description
`get_lists`	Get all available lists
`get_list_items`	Get items from a specific list

Task Tools

Tool	Description
`create_task`	Add a task to the task box

Family Tools

Tool	Description
`get_family_members`	Get family member profiles
`get_frame_info`	Get household/frame information
`get_devices`	List Skylight devices

Reward Tools

Tool	Description
`get_rewards`	Get available rewards
`get_reward_points`	Get reward points balance

Example Queries

Once configured, you can ask Claude things like:

"What's on my calendar today?"
"What chores do I need to do this week?"
"Add 'take out trash' to my chores for tomorrow"
"What's on the grocery list?"
"Add milk to my task list"
"Who are the family members on Skylight?"
"How many reward points does each person have?"

Development

# Run in development mode (with hot reload)
npm run dev

# Build
npm run build

# Run tests
npm test

# Type check
npm run typecheck

API Documentation

This MCP server is built on top of the reverse-engineered Skylight API. The API endpoints were documented using the skylight-api project, which converts browser network traffic (HAR files) into an OpenAPI specification.

API Resources:

If you discover new API endpoints or find issues with the current documentation, please contribute to the skylight-api repository.

Contributing

Contributions are welcome! Here's how you can help:

Fork the repository and create a feature branch
Make your changes with clear, descriptive commits
Run tests (npm test) and linting (npm run lint) before submitting
Open a pull request with a description of your changes

Development Setup

git clone https://github.com/TheEagleByte/skylight-mcp.git
cd skylight-mcp
npm install
npm run dev  # Start with hot reload

Areas for Contribution

Adding support for new Skylight API endpoints
Improving error handling and edge cases
Enhancing documentation
Writing additional tests

Issues & Support

Bug reports: Open an issue with steps to reproduce
Feature requests: Open an issue describing the use case
Questions: Start a discussion or open an issue

Please include relevant details like your Node.js version, error messages, and configuration (with sensitive values redacted).

License

MIT

Disclaimer

This is an unofficial integration. The Skylight API is reverse-engineered and may change without notice. Use at your own risk.