TimeEdit MCP Server

MCP server for TimeEdit .ics schedules.

The server accepts a TimeEdit ICS link at startup, downloads/parses events, and caches results for up to 24 hours.

Useful for connecting MCP clients (like Claude) to TimeEdit schedules, enabling you to ask for info regarding exam halls, lecture dates, etc. without manual calendar browsing.

Get your .ics link

1. Go to your institution's TimeEdit page and find the calendar you want to query.
2. Look for the "Subscribe" option (see image).
3. Copy the provided .ics URL (it should end with .ics)

Note: This is the URL you will provide as an argument at startup.

Quick start (PyPI)

Install uv first: https://docs.astral.sh/uv/getting-started/installation/

Add this to claude_desktop_config.json (no source checkout needed):

{
  "mcpServers": {
    "timeedit-mcp": {
      "command": "uvx",
      "args": ["timeedit-mcp"],
      "env": {
        "TIMEEDIT_ICS_URL": "https://...your-timeedit-link....ics",
        "TIMEEDIT_OUTPUT_TIMEZONE": "Europe/Stockholm"
      }
    }
  }
}

Development (from source)

git clone git@github.com:ekvanox/timeedit-mcp.git
cd timeedit-mcp
uv sync
uv run main.py --ics-url "https://...your-timeedit-link....ics"

# Alternative with env vars
# TIMEEDIT_ICS_URL="https://...your-timeedit-link....ics" TIMEEDIT_OUTPUT_TIMEZONE="Europe/Stockholm" uv run main.py

Docker

The container uses uv for dependency installation and startup. Docker uses an HTTP entrypoint on port 8888.

docker build -t timeedit-mcp .
docker run -d --name timeedit-mcp --restart unless-stopped \
  -p 8888:8888 \
  -e TIMEEDIT_ICS_URL="https://...your-timeedit-link....ics" \
  -e TIMEEDIT_OUTPUT_TIMEZONE="Europe/Stockholm" \
  timeedit-mcp

Connect to Claude Desktop (MCP server)

1. Open ~/Library/Application Support/Claude/claude_desktop_config.json
2. Add this server entry:

{
  "mcpServers": {
    "timeedit-mcp": {
      "command": "uv",
      "args": ["run", "/PATH/TO/PROJECT/timeedit-mcp/main.py"],
      "env": {
        "TIMEEDIT_ICS_URL": "https://...your-timeedit-link....ics",
        "TIMEEDIT_OUTPUT_TIMEZONE": "Europe/Stockholm"
      }
    }
  }
}

3. Restart Claude Desktop.

Claude skill

This repo includes a ready-to-use skill file at SKILL.md.

Easiest way to add it to Claude

1. Create a skill folder named timeedit-mcp under your Claude skills directory.
2. Copy this repo's SKILL.md into that folder as SKILL.md.
3. Restart Claude (or reload customizations) so it picks up the new skill.

Typical location on macOS:

• ~/.claude/skills/timeedit-mcp/SKILL.md

Available MCP tools

Response format

All tools return TOON data (token efficient JSON alternative).

Tool reference

Notes

• Cache is stored under ~/.cache/timeedit-mcp/.
• Cache TTL is max 24 hours.
• Event times default to the server system timezone. Override with --output-timezone IANA_NAME (e.g. --output-timezone Europe/Stockholm) or set the TIMEEDIT_OUTPUT_TIMEZONE environment variable at server startup.

License

MIT. See LICENSE.