MCP server
Tmdb MCP Server
Search, detail, and discovery for movies, TV, and people on The Movie Database (TMDB).
- Pricing
- Open source
- Runs
- Locally or Remotely
- Version
- 0.2.0
- Listing updated
- 4 days ago
About Tmdb MCP Server
Tmdb MCP Server is an open-source MCP server. It can run locally on your machine or as a hosted remote server.
Install
Run in a terminal
claude mcp add tmdb-mcp-server --env TMDB_API_KEY='<TMDB_API_KEY>' -- npx -y @cyanheads/tmdb-mcp-serverAdd to claude_desktop_config.json
{
"mcpServers": {
"tmdb-mcp-server": {
"command": "npx",
"args": [
"-y",
"@cyanheads/tmdb-mcp-server"
],
"env": {
"TMDB_API_KEY": "<TMDB_API_KEY>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"tmdb-mcp-server": {
"command": "npx",
"args": [
"-y",
"@cyanheads/tmdb-mcp-server"
],
"env": {
"TMDB_API_KEY": "<TMDB_API_KEY>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"tmdb-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@cyanheads/tmdb-mcp-server"
],
"env": {
"TMDB_API_KEY": "<TMDB_API_KEY>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"tmdb-mcp-server": {
"command": "npx",
"args": [
"-y",
"@cyanheads/tmdb-mcp-server"
],
"env": {
"TMDB_API_KEY": "<TMDB_API_KEY>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"tmdb-mcp-server": {
"command": "npx",
"args": [
"-y",
"@cyanheads/tmdb-mcp-server"
],
"env": {
"TMDB_API_KEY": "<TMDB_API_KEY>"
}
}
}
}Configuration
TMDB_API_KEYTMDB v4 API Read Access Token (JWT). Sent as 'Authorization: Bearer'. Create one at https://www.themoviedb.org/settings/api.RequiredTMDB_LANGUAGEDefault response language as ISO 639-1, optionally with region (e.g. 'en-US'). Per-call language overrides it.TMDB_DEFAULT_REGIONISO 3166-1 country example in discovery missing-watch_region errors; never a query default.MCP_LOG_LEVELSets the minimum log level for output (e.g., 'debug', 'info', 'warn').TMDB_API_KEYTMDB v4 API Read Access Token (JWT). Sent as 'Authorization: Bearer'. Create one at https://www.themoviedb.org/settings/api.RequiredTMDB_LANGUAGEDefault response language as ISO 639-1, optionally with region (e.g. 'en-US'). Per-call language overrides it.TMDB_DEFAULT_REGIONISO 3166-1 country example in discovery missing-watch_region errors; never a query default.MCP_HTTP_HOSTThe hostname for the HTTP server.MCP_HTTP_PORTThe port to run the HTTP server on.MCP_HTTP_ENDPOINT_PATHThe endpoint path for the MCP server.MCP_AUTH_MODEAuthentication mode to use: 'none', 'jwt', or 'oauth'.MCP_LOG_LEVELSets the minimum log level for output (e.g., 'debug', 'info', 'warn').MCP_TRANSPORT_TYPESelects the HTTP transport.
Pricing
Open source
Tmdb MCP Server FAQ
Is Tmdb MCP Server free?
Yes. Tmdb MCP Server is open source, so you can use and self-host it for free.
How do I add Tmdb MCP Server to Claude Code?
Run this command in your terminal: claude mcp add tmdb-mcp-server --env TMDB_API_KEY='<TMDB_API_KEY>' -- npx -y @cyanheads/tmdb-mcp-server