supershift-mcp

supershift-mcp is a small MCP and HTTP bridge for schedules exported from Supershift.

Research result

As of 2026-06-21, I could not find a documented public Supershift API or an existing Supershift MCP server. The public Supershift pages document local use, optional Cloud Sync, calendar sharing, and export to external calendars. Google Play also lists Android Calendar Export as a Pro feature.

This project therefore uses the stable integration point Supershift exposes to users: exported calendar data, usually an .ics file or a private calendar URL from the target calendar provider.

It deliberately does not reverse engineer Supershift Cloud Sync or private app storage. The current bridge is read-oriented. It can list shifts, find the next shift, and summarize hours from an exported calendar.

Features

• MCP stdio server for AI clients
• Optional FastAPI HTTP API
• Reads local .ics files or HTTPS calendar URLs
• Lists shifts in a date range
• Returns the next shift
• Summarizes worked hours by shift title

Install

python3 -m pip install "git+https://github.com/Zyrial96/supershift-mcp.git"

For local development:

python3 -m venv .venv
. .venv/bin/activate
python -m pip install -e ".[api,dev]"
pytest

Configure

Set SUPERSHIFT_ICS to either a local .ics file or a private calendar URL:

export SUPERSHIFT_ICS="/path/to/supershift.ics"

or:

export SUPERSHIFT_ICS="https://calendar.example/private/supershift.ics"

On Android, Supershift Pro can export shifts to Google Calendar. You can then use a private iCal URL for that calendar, or periodically export an .ics file.

Run MCP

supershift-mcp

Example MCP client configuration:

{
  "mcpServers": {
    "supershift": {
      "command": "supershift-mcp",
      "env": {
        "SUPERSHIFT_ICS": "/path/to/supershift.ics"
      }
    }
  }
}

Available tools:

• calendar_status(calendar: str | None = None)
• list_shifts(start: str, end: str, calendar: str | None = None)
• filter_shifts(start: str, end: str, calendar: str | None = None, title_contains: str | None = None, location_contains: str | None = None, notes_contains: str | None = None, min_hours: float | None = None, max_hours: float | None = None)
• get_shift(uid: str, calendar: str | None = None)
• current_shift(at: str | None = None, calendar: str | None = None)
• shifts_on_date(day: str, calendar: str | None = None)
• next_shift(after: str | None = None, days: int = 90, calendar: str | None = None)
• summarize_shifts(start: str, end: str, calendar: str | None = None)
• summarize_by_period(start: str, end: str, period: str = "day", calendar: str | None = None, include_all_day: bool = False)
• detect_conflicts(start: str, end: str, calendar: str | None = None)
• rest_periods(start: str, end: str, calendar: str | None = None, minimum_hours: float = 11)
• free_days(start: str, end: str, calendar: str | None = None)
• export_shifts(start: str, end: str, output_format: str = "json", calendar: str | None = None)
• estimate_pay(start: str, end: str, hourly_rate: float, calendar: str | None = None, title_rates: dict[str, float] | None = None, currency: str = "EUR", include_all_day: bool = False)
• shift_titles(calendar: str | None = None)
• shift_locations(calendar: str | None = None)
• upcoming_shifts(days: int = 14, calendar: str | None = None)

Run HTTP API

Install the API extra first:

python -m pip install -e ".[api]"

Then start the server:

supershift-api

Endpoints:

• GET /health
• GET /shifts?start=2026-06-01&end=2026-07-01
• GET /shifts/filter?start=2026-06-01&end=2026-07-01&title_contains=Night
• GET /shifts/current
• GET /shifts/next?days=30
• GET /shifts/date/2026-06-21
• GET /shifts/{uid}
• GET /summary?start=2026-06-01&end=2026-07-01
• GET /summary/period?start=2026-06-01&end=2026-07-01&period=week
• GET /conflicts?start=2026-06-01&end=2026-07-01
• GET /rest-periods?start=2026-06-01&end=2026-07-01
• GET /free-days?start=2026-06-01&end=2026-07-01
• GET /export?start=2026-06-01&end=2026-07-01&output_format=csv
• GET /pay?start=2026-06-01&end=2026-07-01&hourly_rate=20
• GET /titles
• GET /locations

Boundaries

This is not an official Supershift product. It cannot create or edit entries inside the Supershift Android app unless Supershift publishes a supported write API in the future. Writing directly into Cloud Sync or private app storage would be fragile and may violate user expectations or terms.