# SchedJoules Calendars

> SchedJoules Calendars is an MCP server for productivity. Public holiday, sports, TV and event calendars that AI assistants can search and query. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Platforms:** API, iOS, Android, Web
- **Website:** https://www.schedjoules.com/llms.txt
- **MCP Registry name:** io.github.schedjoules/calendars
- **Categories:** [productivity](https://ai-powered.com/categories/productivity)
- **Listing updated:** 2026-11-20

## About

SchedJoules is a catalogue of public calendars covering public and school holidays, sports fixtures and results, TV listings, weather forecasts, moon phases and company financial events. Its MCP server lets an assistant search for calendars, list upcoming events and produce a subscribe link, all through read-only tools that need no sign-in.

Beyond the MCP endpoint, the same catalogue is reachable over plain HTTP. Searches return markdown lists of matching calendars, and shared calendar links can be fetched as markdown to see their next events. When a user wants a calendar on their phone, the link opens the SchedJoules app, which subscribes their own calendar app to it and keeps it updated.

It suits people who want dates of holidays, matches or broadcasts in the calendar they already use, and developers of calendar apps who need a licensed feed. Event previews are limited to a small sample per calendar; the full calendars live in the apps.

## Features

- **Calendar search:** Finds public calendars by keyword, such as a sport or a country's holidays.
- **Upcoming events lookup:** Returns the next events for a chosen calendar.
- **Subscribe links:** Produces a link that adds a calendar to the user's own calendar app.
- **Broad topic coverage:** Includes holidays in many countries, school terms, sports, TV, weather and finance.
- **Automatic updates:** Calendars are kept current by the service so subscribers see changes.
- **Markdown over plain HTTP:** Calendar pages can be read as markdown without using MCP.

## Good for

- Asking an assistant when the next public holiday falls in a given country
- Finding the fixture schedule for a favourite team or competition
- Adding a sports or TV calendar to a phone calendar app
- Checking upcoming school holidays for family planning
- Looking up moon phases or week numbers inside a scheduling assistant

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http calendars https://www.schedjoules.com/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://www.schedjoules.com/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "calendars": {
      "url": "https://www.schedjoules.com/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "calendars": {
      "type": "http",
      "url": "https://www.schedjoules.com/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "calendars": {
      "serverUrl": "https://www.schedjoules.com/mcp"
    }
  }
}
```

### Grok Bot (Grok Bot desktop app → Connect apps → Add a custom connector)

```sh
https://www.schedjoules.com/mcp
```

Enter a Name (for example "SchedJoules Calendars"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin.

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "calendars": {
      "type": "http",
      "url": "https://www.schedjoules.com/mcp"
    }
  }
}
```

## Tools

All 3 tools say they're read-only. From the server's own tool annotations; not verified by us.

- `search_calendars` (says read-only): Search the SchedJoules catalogue of public calendars by a few words (a team, competition, country or kind of holiday). Returns up to 20 calendars with id, name and details.
- `get_upcoming_events` (says read-only): The next events on a calendar: at most 5 in the next 60 days, with title and start. For a folder of calendars, its calendars instead.
- `get_subscribe_link` (says read-only): The link that adds a calendar to the user's own calendar app (Google, Apple, Outlook) through the SchedJoules app and keeps it up to date. Give it to the user to open on their phone.

## FAQ

### Does the MCP server require sign-in?

No. It connects over Streamable HTTP and needs no sign-in.

### Which tools does the MCP server provide?

It offers three read-only tools: search_calendars, get_upcoming_events and get_subscribe_link.

### How many countries are covered for public holidays?

Public holidays cover 241 countries and 350 regions.

### Can I get the full calendar data for my own app?

Calendar apps can license the catalogue through the Interesting Public Calendar API, with an API key requested from the vendor.

### How do I add SchedJoules Calendars to Claude Code?

Run this command in your terminal: claude mcp add --transport http calendars https://www.schedjoules.com/mcp

### What are the best alternatives to SchedJoules Calendars?

The closest alternatives to SchedJoules Calendars are Google Calendar, Calendar.app, SYNCDATE, Kalender Sync and Smart Calendars AI.

## Where this comes from

- Description: written from the project's website and its MCP Registry entry.
- Status and tools: checked automatically by AIPoweredBot on 21 November 2026.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Google Calendar](https://ai-powered.com/mcp/google-calendar-2): Google Calendar is an open-source MCP server for productivity.
- [Calendar.app](https://ai-powered.com/mcp/calendar-app): Calendar.app is an open-source MCP server for productivity.
- [SYNCDATE](https://ai-powered.com/mcp/syncdate): SYNCDATE is a freemium MCP server for productivity.
- [Kalender Sync](https://ai-powered.com/mcp/kalender-sync): Kalender Sync is a freemium MCP server for productivity.
- [Smart Calendars AI](https://ai-powered.com/mcp/smart-calendars-ai): Smart Calendars AI is a freemium MCP server for productivity.
- [Calensync](https://ai-powered.com/mcp/calensync): Calensync is an MCP server for productivity.
- [Ridian Calendar Feeds](https://ai-powered.com/mcp/ridian-calendar-feeds): Ridian Calendar Feeds is a freemium MCP server for productivity.
- [CalDAV MCP Server](https://ai-powered.com/mcp/caldav-mcp-server): CalDAV MCP Server is an open-source MCP server for productivity.

---
Source: https://ai-powered.com/mcp/schedjoules-calendars-2
