Log inSubmit server
Skylight MCP logo

Skylight MCP

Connects AI clients to Skylight Calendar for family scheduling, lists, chores, rewards, meals, messages, media, and household settings.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Skylight MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "skylight-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "skylight-mcp"
      ],
      "env": {
        "SKYLIGHT_REFRESH_TOKEN": "YOUR_VALUE_HERE",
        "SKYLIGHT_EMAIL": "YOUR_VALUE_HERE",
        "SKYLIGHT_PASSWORD": "YOUR_VALUE_HERE",
        "SKYLIGHT_FRAME_ID": "YOUR_VALUE_HERE",
        "SKYLIGHT_APPLE_APP_PASSWORD": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Automated check passed— started and listed 114 tools correctly (Today).

Overview

The skylight-mcp MCP server exposes Skylight Calendar data and actions through 114 MCP tools. It supports reading and changing events, shared lists, chores, rewards, task-box items, meals, messages, albums, devices, frames, calendars, and family members. Authentication uses either a refresh token or a headless email-and-password OAuth2 flow, with credentials read from environment variables. Reach for it when an AI client needs to manage a Skylight household rather than only retrieve calendar events.

Use cases

  • Manage family calendar events and member assignments
  • Update shared household lists and task-box items
  • Track chores, rewards, and family reward points
  • Draft meal plans and activity ideas for review
  • Change Skylight frame, device, calendar, and member settings

Key features

  • 114 Skylight Calendar tools
  • Calendar event read and write operations
  • Shared lists, chores, rewards, meals, and task-box management
  • Messages, albums, and photo/video uploads
  • Frame, device, calendar, and family-member administration
  • OAuth2 login with refresh-token support

Tools114

What Skylight MCP lets your agent do. Expand a tool for its parameters.

Verified live~15.3k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 3d ago

Recent health check succeeded.

4/4 checks healthy over the last 35d

What it can do

From the 114 tools this server returned when we ran it; 114 declare their own safety hints.

Can delete or modify data · 31Handles credentials · 19Makes network requests · 114Read-only tools · 83
Network at startup3 connections
Files written at startupNone
Install scriptsNone
npm provenanceSigned build
Package age144 days
Maintainers1

Observed 2026-10-22 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 7d ago via OSV.dev · skylight-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars14Stargazers on the source repository.
npm downloads5.3kPackage downloads in the last 30 days.
Last commit3d agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed114Callable tools this server registers over MCP.
Directory activity1 viewsConfig copies, upvotes, and views on AllMCPs.

How Skylight MCP works

What skylight-mcp MCP server does

The skylight-mcp MCP server connects an MCP-compatible host to Skylight Calendar at app.ourskylight.com. Its 114 tools cover household data and actions across calendar events, shared lists, chores, rewards, task-box items, meals, messages, albums, photos, videos, frames, devices, calendars, and family members.

Calendar tools can list and inspect events, create or change them, delete them, assign family-member categories, and manage event notification settings. Other tools handle shared-list contents, chore and reward data, meal planning, activity ideas, household messages, albums, and media uploads. Frame and account tools expose devices, calendars, members, avatars, household configuration, subscription status, and reward-point balances. Write operations that affect users or send invitations may require confirmation.

How it works

The package communicates with Skylight using the MCP stdio transport. It does not open a network listener, although a host can place it behind authenticated HTTP. The implementation uses the official TypeScript SDK v2 and supports the stateless 2026-07-28 protocol revision as well as clients using the 2025-11-25 initialization handshake.

Authentication is deferred until the first tool call. With an email and password, the client obtains a CSRF-protected session, completes an OAuth2 authorization-code flow with S256 PKCE, and receives access and refresh tokens. An existing refresh token can be supplied instead. Access tokens are refreshed before expiry and retried after a 401 response. Requests include Skylight API version 2026-05-01, which is needed for supported API features.

Setup and configuration

The skylight-mcp MCP server starts without credentials, allowing an MCP host to complete tool discovery before authentication is configured. Set SKYLIGHT_EMAIL and SKYLIGHT_PASSWORD for login, or set SKYLIGHT_REFRESH_TOKEN when a refresh token is already available. The authentication flow does not use SSO, two-factor authentication, or a browser extension.

All Skylight data belongs to a frame. The client automatically discovers the account's only frame. Accounts with multiple frames should set SKYLIGHT_FRAME_ID; individual frame-scoped tools can also receive a frameId override. Apple calendar linking uses SKYLIGHT_APPLE_APP_PASSWORD rather than accepting that secret as a tool argument.

Tools and capabilities

  • Read and modify calendar events, source calendars, categories, and notifications.
  • Create and manage shared lists, chores, rewards, meals, and task-box items.
  • Generate meal plans and activity ideas as drafts that can be reviewed and approved.
  • Read and write messages and albums, including photo and video uploads.
  • Manage frames, devices, household settings, users, family members, calendars, and avatars.

Limitations and notes

The server is stdio-only and does not itself provide an HTTP listener. Credentials are optional at startup but required for authenticated tool use. Refresh tokens rotate, so clients or programs using the exported authentication helpers must retain the newly returned token. Accounts with multiple frames need explicit frame selection to avoid relying on automatic single-frame discovery.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Skylight MCP

skylight-mcp is an MCP server that connects AI clients to Skylight Calendar. Its main tools read and modify calendar events, shared lists, chores, rewards, task-box items, meals, messages, albums, frames, devices, calendars, and family members, with additional tools for meal-plan and activity-idea drafts.

Set SKYLIGHT_REFRESH_TOKEN, or provide SKYLIGHT_EMAIL and SKYLIGHT_PASSWORD for the server's headless OAuth2 login flow. Authentication starts on the first tool call, and the client refreshes access tokens proactively and after unauthorized responses.

Set SKYLIGHT_FRAME_ID when the Skylight account has more than one frame. With a single frame, the client discovers it automatically; frame-scoped tools also accept an optional frameId argument to override the default.

It documents a stdio MCP transport, so compatibility depends on whether the host can launch and use a stdio MCP server; the package itself does not open a network listener.

Related MCP servers

All in Workplace & Productivity All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewSkylight MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/skylight-mcp?style=directory)](https://allmcps.com/mcp/skylight-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/skylight-mcp"><img src="https://allmcps.com/api/badge/skylight-mcp?style=directory" alt="Skylight MCP on AllMCPs" /></a>