Overview
TMDB MCP Server is an integration server that connects to The Movie Database (TMDB) API, providing functionalities for movie information retrieval, search capabilities, and personalized movie recommendations.
To use the TMDB MCP Server, you'll need a TMDB API key, and the server must be set up on your local machine. Once installed, you can integrate it with the Claude Desktop Application and send various movie-related queries to get responses.
- Search for movies by title or keywords - Get movie recommendations based on specific movie IDs - Access trending movies for the day or the week - Fetch comprehensive details about movies, including cast and reviews
- Instantly searching for movies matching specific themes or keywords.
- Getting personalized movie recommendations based on past viewing history.
- Discovering trending movies to watch based on current popularity.
Add to your AI client
Use these steps to connect TMDB MCP Server in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.
Cursor
Add this to your .cursor/mcp.json file in your project root, then restart Cursor.
.cursor/mcp.json
{
"mcpServers": {
"mcp-server-tmdb-laksh-star": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-server-tmdb-laksh-star"
]
}
}
}Claude Desktop
Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.
~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)
{
"mcpServers": {
"mcp-server-tmdb-laksh-star": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-server-tmdb-laksh-star"
]
}
}
}Claude Code
Add this to your project's .mcp.json file. Claude Code will detect it automatically.
.mcp.json (project root)
{
"mcpServers": {
"mcp-server-tmdb-laksh-star": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-server-tmdb-laksh-star"
]
}
}
}VS Code (Copilot)
Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.
.vscode/mcp.json
{
"servers": {
"mcp-server-tmdb-laksh-star": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-server-tmdb-laksh-star"
]
}
}
}Windsurf
Add this to your Windsurf MCP config file, then restart Windsurf.
~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mcp-server-tmdb-laksh-star": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-server-tmdb-laksh-star"
]
}
}
}Cline
Open Cline settings, navigate to MCP Servers, and add this server configuration.
Cline MCP Settings (via UI)
{
"mcpServers": {
"mcp-server-tmdb-laksh-star": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-server-tmdb-laksh-star"
]
}
}
}FAQ
How do I obtain the TMDB API key?
You need to sign up at TMDB, create an account, and request an API key from your settings.
What are the system requirements?
The server works on macOS (10.15+), Windows 10/11, and modern Linux distributions, requiring at least 4GB RAM and a stable internet connection.
Can I contribute to the project?
Yes! Contributions are welcome via Pull Requests.