Before installing and running the TMDB MCP server, ensure you have the following prerequisites installed and configured:
Required Software
Node.js
npm (Node Package Manager)
TypeScript
Required Accounts & API Keys
TMDB Account
Claude Desktop Application
System Requirements
Operating Systems
Hardware Requirements
Development Environment
For the best development experience, we recommend:
A code editor with TypeScript support (e.g., VS Code)
Terminal access
Git (for version control)
Features
Tools
search_movies
get_recommendations
get_trending
Resources
The server provides access to TMDB movie information:
Movies (tmdb:///movie/<movie_id>)
Get a TMDB API key:
Clone and set up the project:
Build the server:
Set up your environment variable:
Usage with Claude Desktop
To integrate this server with Claude Desktop, add the following to your app's server configuration file (located at ~/Library/Application Support/Claude/config.json):
Replace /full/path/to with the actual path to your project directory.
Installing via Smithery
To install TMDB Server for Claude Desktop automatically via Smithery:
Example Usage
Once the server is running with Claude Desktop, you can use commands like:
Search for movies:
Get trending movies:
Get movie recommendations:
Get movie details:
Error Handling
The server includes comprehensive error handling for:
Invalid API keys
Network errors
Invalid movie IDs
Malformed requests
Error messages will be returned in a user-friendly format through Claude Desktop.
Development
To watch for changes during development:
License
This MCP server is licensed under the MIT License. See the LICENSE file for details.
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
Before installing and running the TMDB MCP server, ensure you have the following prerequisites installed and configured:
Required Software
Node.js
npm (Node Package Manager)
TypeScript
Required Accounts & API Keys
TMDB Account
Claude Desktop Application
System Requirements
Operating Systems
Hardware Requirements
Development Environment
For the best development experience, we recommend:
A code editor with TypeScript support (e.g., VS Code)
Terminal access
Git (for version control)
Features
Tools
search_movies
get_recommendations
get_trending
Resources
The server provides access to TMDB movie information:
Movies (tmdb:///movie/<movie_id>)
Get a TMDB API key:
Clone and set up the project:
Build the server:
Set up your environment variable:
Usage with Claude Desktop
To integrate this server with Claude Desktop, add the following to your app's server configuration file (located at ~/Library/Application Support/Claude/config.json):
Replace /full/path/to with the actual path to your project directory.
Installing via Smithery
To install TMDB Server for Claude Desktop automatically via Smithery:
Example Usage
Once the server is running with Claude Desktop, you can use commands like:
Search for movies:
Get trending movies:
Get movie recommendations:
Get movie details:
Error Handling
The server includes comprehensive error handling for:
Invalid API keys
Network errors
Invalid movie IDs
Malformed requests
Error messages will be returned in a user-friendly format through Claude Desktop.
Development
To watch for changes during development:
License
This MCP server is licensed under the MIT License. See the LICENSE file for details.
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.