Quick Setup
Getting Started with TomTom MCP Server
The TomTom MCP Server enables AI assistants to access TomTom's location APIs through the Model Context Protocol (MCP). Follow these steps to quickly set up and start using TomTom MCP Server with your AI workflows.
Prerequisites
Before you begin, ensure you have:
- TomTom API key - Sign up for a free account to get your API key
- Node.js 22 or later installed on your system
- An MCP-compatible AI client (Claude Desktop, Cursor, VS Code with Copilot, Smolagent, etc.)
Step 1: Install TomTom MCP Server
Choose one of the following installation methods:
Option A: NPM Package (Recommended)
The simplest way to use TomTom MCP Server is through the NPM package:
1# Run directly with npx (no installation required)2# Set your API key as an environment variable3export TOMTOM_API_KEY="your_api_key_here"45# Then run the MCP server6npx -y @tomtom-org/tomtom-mcp
Option B: Local Development
For developers who want to explore or modify the code from the open source repository:
1# Clone the repository2git clone https://github.com/tomtom-international/tomtom-mcp34# Navigate to the directory5cd tomtom-mcp67# Install dependencies8npm install910# Build the package11npm run build1213# Run the server14npm start
Step 2: Configure Your MCP Client
Add the TomTom MCP Server to your AI client's configuration:
1{2 "mcpServers": {3 "tomtom-navigation": {4 "command": "npx",5 "args": ["-y", "@tomtom-org/tomtom-mcp"],6 "env": {7 "TOMTOM_API_KEY": "your_api_key_here"8 }9 }10 }11}
Replace "your_api_key_here"
with your actual TomTom API key. The env
property ensures the API key is passed as an environment variable to the MCP server.
Step 3: Test the Connection
Once configured, test that your AI assistant can access TomTom's services by asking a simple location-based question:
What's at the coordinates 52.3676, 4.9041?
Your AI assistant should be able to use the TomTom MCP Server to retrieve the address and other location details.