Which integrations are available for this server?

Allows searching and retrieving movie, series, and episode data using the OMDb API, which provides information from the IMDb database.

How do I use omdb-mcp?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@omdb-mcp search for movies about time travel" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

omdb-mcp

by Dworf

Overview Schema Related Servers Score Discussions

Python

Remote

omdb-mcp

An MCP (Model Context Protocol) server for the OMDb API — search movies, series, and episodes from any MCP-compatible client.

Built with FastMCP. Supports both STDIO and Streamable HTTP transports, with optional bearer-token auth for HTTP mode.

Features

Five tools: search_movies, get_by_title, get_by_imdb_id, get_episode, get_season
Dual transport: STDIO (for MetaMCP / Claude Desktop / Hermes) and Streamable HTTP (for standalone agents)
Optional bearer-token authentication for HTTP mode
Configuration via .env or environment variables
Minimal dependencies: fastmcp, httpx, python-dotenv

Related MCP server: moviefinder-mcp

Install

# Recommended: run directly with uvx (no install needed)
uvx omdb-mcp

# Or install into your environment
pip install omdb-mcp

Get a free OMDb API key at https://www.omdbapi.com/apikey.aspx (1,000 requests/day on the free tier).

Configuration

All settings come from environment variables (a .env file in the working directory is auto-loaded).

Variable	Default	Description
`OMDB_API_KEY`	(required)	Your OMDb API key
`OMDB_MCP_TRANSPORT`	`stdio`	`stdio` or `http`
`OMDB_MCP_HOST`	`127.0.0.1`	HTTP bind address (`0.0.0.0` for LAN/Docker)
`OMDB_MCP_PORT`	`8087`	HTTP port
`OMDB_MCP_PATH`	`/mcp`	HTTP mount path
`OMDB_MCP_AUTH_TOKEN`	(unset)	If set, HTTP clients must send `Authorization: Bearer ...`
`OMDB_MCP_LOG_LEVEL`	`INFO`	`DEBUG`, `INFO`, `WARNING`, `ERROR`
`OMDB_REQUEST_TIMEOUT`	`10`	OMDb HTTP timeout (seconds)
`OMDB_BASE_URL`	`https://www.omdbapi.com/`	Override only if proxying/mirroring OMDb

See .env.example for a copy-paste template.

Running

STDIO mode (for MCP clients that spawn the process)

omdb-mcp
# or with uv:
uvx omdb-mcp

Streamable HTTP mode (for standalone, long-lived service)

omdb-mcp-http
# or override port/host:
omdb-mcp-http --port 8087 --host 0.0.0.0

CLI flags --transport, --host, --port, --path override env vars.

Client setup

MetaMCP

Option A — STDIO (simplest, no service to manage):

Type: STDIO
Command: uvx
Args: omdb-mcp
Env: OMDB_API_KEY=your_key_here

Option B — Streamable HTTP (standalone service):

Run the server on the host:

OMDB_API_KEY=your_key OMDB_MCP_AUTH_TOKEN=mysecret omdb-mcp-http

In MetaMCP:

Type: Streamable HTTP
URL: http://host.docker.internal:8087/mcp
Header: Authorization: Bearer mysecret (if OMDB_MCP_AUTH_TOKEN is set)

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "omdb": {
      "command": "uvx",
      "args": ["omdb-mcp"],
      "env": {
        "OMDB_API_KEY": "your_key_here"
      }
    }
  }
}

Cursor / Windsurf / Cline

Same JSON shape, different config path. Cursor reads ~/.cursor/mcp.json:

{
  "mcpServers": {
    "omdb": {
      "command": "uvx",
      "args": ["omdb-mcp"],
      "env": { "OMDB_API_KEY": "your_key_here" }
    }
  }
}

Generic Streamable HTTP client

{
  "mcpServers": {
    "omdb": {
      "url": "http://127.0.0.1:8087/mcp",
      "headers": {
        "Authorization": "Bearer your_token_here"
      }
    }
  }
}

Tools

Tool	OMDb param(s)	Description
`search_movies`	`s`, `y`, `type`, `page`	Free-text search (paginated, 10 per page)
`get_by_title`	`t`, `y`, `type`, `plot`	Lookup by exact title
`get_by_imdb_id`	`i`, `plot`	Lookup by IMDb ID (`tt...`)
`get_episode`	`i`/`t`, `Season`, `Episode`, `plot`	Single TV episode
`get_season`	`i`/`t`, `Season`	All episodes in a season

Running as a service (HTTP mode)

macOS — launchd

Create ~/Library/LaunchAgents/com.dworf.omdb-mcp.plist:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>Label</key><string>com.dworf.omdb-mcp</string>
    <key>ProgramArguments</key>
    <array>
        <string>/Users/YOU/.local/bin/uvx</string>
        <string>omdb-mcp-http</string>
    </array>
    <key>EnvironmentVariables</key>
    <dict>
        <key>OMDB_API_KEY</key><string>your_key_here</string>
        <key>OMDB_MCP_AUTH_TOKEN</key><string>your_token_here</string>
        <key>OMDB_MCP_HOST</key><string>127.0.0.1</string>
        <key>OMDB_MCP_PORT</key><string>8087</string>
    </dict>
    <key>RunAtLoad</key><true/>
    <key>KeepAlive</key><true/>
    <key>StandardOutPath</key><string>/tmp/omdb-mcp.log</string>
    <key>StandardErrorPath</key><string>/tmp/omdb-mcp.err</string>
</dict>
</plist>

Load it:

launchctl load ~/Library/LaunchAgents/com.dworf.omdb-mcp.plist
# stop / unload:
launchctl unload ~/Library/LaunchAgents/com.dworf.omdb-mcp.plist

Linux — systemd

Create ~/.config/systemd/user/omdb-mcp.service:

[Unit]
Description=OMDb MCP server (Streamable HTTP)
After=network.target

[Service]
ExecStart=%h/.local/bin/uvx omdb-mcp-http
Environment=OMDB_API_KEY=your_key_here
Environment=OMDB_MCP_AUTH_TOKEN=your_token_here
Environment=OMDB_MCP_HOST=127.0.0.1
Environment=OMDB_MCP_PORT=8087
Restart=on-failure
RestartSec=5

[Install]
WantedBy=default.target

systemctl --user daemon-reload
systemctl --user enable --now omdb-mcp
systemctl --user status omdb-mcp
journalctl --user -u omdb-mcp -f

Docker

FROM python:3.12-slim
RUN pip install --no-cache-dir omdb-mcp
EXPOSE 8087
ENV OMDB_MCP_HOST=0.0.0.0 OMDB_MCP_PORT=8087
CMD ["omdb-mcp-http"]

docker build -t omdb-mcp .
docker run -d --name omdb-mcp -p 8087:8087 \
  -e OMDB_API_KEY=your_key \
  -e OMDB_MCP_AUTH_TOKEN=your_token \
  --restart unless-stopped omdb-mcp

Development

git clone https://github.com/Dworf/omdb-mcp
cd omdb-mcp
uv venv && source .venv/bin/activate
uv pip install -e ".[dev]"
pytest

Security note

If you bind to 0.0.0.0 without setting OMDB_MCP_AUTH_TOKEN, anyone on the network can use your OMDb API key. The server logs a warning at startup in that case — set a token in any non-localhost deployment.

Changelog

v0.1.0 — 2026-05-14

Initial release.
Five tools: search_movies, get_by_title, get_by_imdb_id, get_episode, get_season.
Dual transport: STDIO (default) and Streamable HTTP.
Optional bearer-token auth for HTTP mode.
.env loading via python-dotenv.
20 unit tests; smoke-tested against the live OMDb API.

Acknowledgements

OMDb API — Brian Fritz's free movie/series database. If you use this MCP server in production, please consider donating to OMDb or upgrading to a Patreon-tier key.
FastMCP — the Python MCP framework this server is built on.
Model Context Protocol — the open protocol that makes this possible.

License

MIT

Install Server

license - permissive license

quality

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

1Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

Related MCP Servers

Movie Search MCP Server
tonderflash
A
license
D
quality
D
maintenance
An MCP server that allows users to search for movies, get detailed information, receive genre-based recommendations, and discover popular/trending films using OMDb and TMDb APIs.
Last updated 2025-07-20
5
22
MIT
moviefinder-mcp
Entertainment & Media Search
AmeliaMiddleton
F
license
A
quality
D
maintenance
An MCP server that wraps The Movie Database (TMDB) API, enabling search for movies and TV shows, retrieval of movie details, recommendations, similar movies, trending content, streaming providers, and movie discovery.
Last updated 2026-05-05
8
moviefinder-mcp
Entertainment & Media Search
AmeliaMiddleton
F
license
A
quality
D
maintenance
An MCP server that wraps the TMDB API, enabling search of movies and TV shows, retrieval of details, trending titles, recommendations, and streaming provider information.
Last updated 2026-05-05
8
TMDB MCP Server
Entertainment & Media Search
Amruth2507
F
license
-
quality
D
maintenance
A robust MCP server that wraps The Movie Database API, enabling LLMs to search movies, get details, popular movies, and recommendations.
Last updated 2026-04-06

View all related MCP servers

Related MCP Connectors

Omdb
OMDb MCP — IMDB-derived movie / TV / episode data (BYO key)
mcp-serp
MCP server for Google search results via SERP API
Thegamesdb
TheGamesDB MCP — wraps TheGamesDB API (thegamesdb.net), a community

View all MCP Connectors

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Dworf/omdb-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server

omdb-mcp

Features

Install

Configuration

Running

STDIO mode (for MCP clients that spawn the process)

Streamable HTTP mode (for standalone, long-lived service)

Client setup

MetaMCP

Claude Desktop

Cursor / Windsurf / Cline

Generic Streamable HTTP client

Tools

Running as a service (HTTP mode)

macOS — launchd

Linux — systemd

Docker

Development

Security note

Changelog

v0.1.0 — 2026-05-14

Acknowledgements

License

Maintenance

Resources

Looking for Admin?

Tools

Related MCP Servers

Movie Search MCP Server

moviefinder-mcp

moviefinder-mcp

TMDB MCP Server

Related MCP Connectors

Latest Blog Posts

MCP directory API