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:

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 variable
3export TOMTOM_API_KEY="your_api_key_here"
4
5# Then run the MCP server
6npx -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 repository
2git clone https://github.com/tomtom-international/tomtom-mcp
3
4# Navigate to the directory
5cd tomtom-mcp
6
7# Install dependencies
8npm install
9
10# Build the package
11npm run build
12
13# Run the server
14npm 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.