Skip to main content

YouSee EPG MCP Server 📺

https://github.com/user-attachments/assets/02aa9b9a-df91-4494-af2a-953402734168

Dansk | English


Dansk

Se hvad der kører i TV via Claude eller ChatGPT. MCP-server til YouSee's danske TV-guide.

Installation

Installer-scriptet sætter alt op for dig: Python, uv og konfiguration af Claude Desktop + Claude Code.

macOS / Linux

Åbn Terminal og kør:

curl -fsSL https://raw.githubusercontent.com/ttopholm/yousee-epg-mcp/main/install.sh | bash

Windows

Åbn PowerShell og kør:

irm https://raw.githubusercontent.com/ttopholm/yousee-epg-mcp/main/install.ps1 | iex

Manuel installation

Hvis du foretrækker at installere manuelt

Claude Code:

claude mcp add yousee-epg -- uvx yousee-epg-mcp

Claude Desktop:

Åbn Settings → Developer → Edit Config og tilføj:

{
  "mcpServers": {
    "yousee-epg": {
      "command": "uvx",
      "args": ["yousee-epg-mcp"]
    }
  }
}

Genstart Claude Desktop bagefter.

Tools

Tool Beskrivelse
yousee_channels Alle tilgængelige TV-kanaler med ID og logo
yousee_programs Programoversigt for en kanal på en dato (±7 dage)
yousee_search Søg efter et program på tværs af alle kanaler
yousee_now_playing Hvad kører lige nu
yousee_prime_time Hvad kører i aften kl. 19-22 på de store kanaler
yousee_genre Find programmer efter genre (Sport, Film, Nyheder, Serier, Børn)

Eksempler

  • "Hvad kører på DR1 lige nu?"
  • "Hvornår sendes Vild med dans?"
  • "Hvad er der i TV i aften?"
  • "Er der sport på TV i dag?"
  • "Vis mig film på TV i morgen"

ChatGPT

ChatGPT kræver en HTTP-server tilgængelig fra internettet:

pip install yousee-epg-mcp
yousee-epg-mcp-http

Gør den tilgængelig med f.eks. Cloudflare Tunnel:

cloudflared tunnel --url http://localhost:8000

Tilføj din URL + /mcp som connector i ChatGPT (kræver Developer Mode + Plus/Pro).

Docker

docker build -t yousee-epg-mcp .
docker run -p 8000:8000 yousee-epg-mcp

API

Bruger YouSee's offentlige EPG — ingen nøgle påkrævet, ±7 dage.

  • GET https://secure.yousee.tv/epg/v2/channels
  • GET https://secure.yousee.tv/epg/v2/channels/:id/:dato

Release

Ny version publiceres automatisk til PyPI ved git tag:

git tag v1.0.0
git push origin v1.0.0

English

Browse Danish TV listings via Claude or ChatGPT. MCP server for YouSee's TV guide.

Installation

The install script handles everything: Python, uv, and configuration for Claude Desktop + Claude Code.

macOS / Linux

Open Terminal and run:

curl -fsSL https://raw.githubusercontent.com/ttopholm/yousee-epg-mcp/main/install.sh | bash

Windows

Open PowerShell and run:

irm https://raw.githubusercontent.com/ttopholm/yousee-epg-mcp/main/install.ps1 | iex

Manual installation

If you prefer to install manually

Claude Code:

claude mcp add yousee-epg -- uvx yousee-epg-mcp

Claude Desktop:

Open Settings → Developer → Edit Config and add:

{
  "mcpServers": {
    "yousee-epg": {
      "command": "uvx",
      "args": ["yousee-epg-mcp"]
    }
  }
}

Restart Claude Desktop afterwards.

Tools

Tool Description
yousee_channels All available TV channels with ID and logo
yousee_programs Program schedule for a channel on a given date (±7 days)
yousee_search Search for a program across all channels
yousee_now_playing What's on right now
yousee_prime_time Prime time shows (19:00–22:00) on major Danish channels
yousee_genre Find programs by genre (Sports, Movies, News, Series, Kids)

Examples

  • "What's on DR1 right now?"
  • "When is Vild med dans on?"
  • "What's on TV tonight?"
  • "Is there any sports on TV today?"
  • "Show me movies on TV tomorrow"

ChatGPT

ChatGPT requires an HTTP server accessible from the internet:

pip install yousee-epg-mcp
yousee-epg-mcp-http

Expose it using e.g. Cloudflare Tunnel:

cloudflared tunnel --url http://localhost:8000

Add your URL + /mcp as a connector in ChatGPT (requires Developer Mode + Plus/Pro).

Docker

docker build -t yousee-epg-mcp .
docker run -p 8000:8000 yousee-epg-mcp

API

Uses YouSee's public EPG — no API key required, ±7 days.

  • GET https://secure.yousee.tv/epg/v2/channels
  • GET https://secure.yousee.tv/epg/v2/channels/:id/:date

Release

New versions are published automatically to PyPI on git tag:

git tag v1.0.0
git push origin v1.0.0

License / Licens

MIT

Metadata

Release files for yousee-epg-mcp 1.0.6

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for yousee-epg-mcp 1.0.6
File Size Uploaded
yousee_epg_mcp-1.0.6.tar.gz 16.1 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for yousee-epg-mcp 1.0.6
File Interpreter ABI Platform
yousee_epg_mcp-1.0.6-py3-none-any.whl Python 3 none any Details

Total release size: 25.5 kB

Release files / yousee_epg_mcp-1.0.6.tar.gz

Download URL yousee_epg_mcp-1.0.6.tar.gz
Size 16.1 kB
Tags Source
SHA-256 checksum
How to use checksums
523687201bf8dbc649918b2f5a9ee2e78217ac0b5c9f49548cf92cd3bd1275ba
BLAKE2b-256 checksum
How to use checksums
3e977f30f601c9cc932b5f7129431a556666a77bdc0194331b80e1afafc1b1fd
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.7

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Mar 20, 2026.

Transparency log

Release files / yousee_epg_mcp-1.0.6-py3-none-any.whl

Download URL yousee_epg_mcp-1.0.6-py3-none-any.whl
Size 9.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
53bd7780c0f69eff2d1ecaaaa6b20423a01da28c9edd055b07cbf164a99fc872
BLAKE2b-256 checksum
How to use checksums
16ba4de3bc96e42e653f53771a42d9eb49ee05825d06e0039d00db38e4b48365
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.7

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Mar 20, 2026.

Transparency log

Release history Release notifications | RSS feed

This release

1.0.6 This release

2 release files

1.0.5

2 release files

1.0.4

2 release files

1.0.3

2 release files

1.0.1

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page