A Model Context Protocol (MCP) server that enables Claude and other AI assistants to access Polarsteps travel data. Query user profiles, trip details, travel statistics, and search through travel histories with natural language.

• User Profiles: Get profile info, social stats, and travel metrics
• Trip Data: Access detailed trip information, timelines, and locations
• Smart Search: Find trips by destination, theme, or keywords with fuzzy matching
• Travel Analytics: Retrieve comprehensive travel statistics and achievements

Until I add it to PyPI, the quickest way to get started is using Smithery:

npx -y @smithery/cli install @remuzel/polarsteps-mcp --client claude

Then configure your Polarsteps token.

You'll need your Polarsteps remember_token to authenticate API requests.

1. Go to https://www.polarsteps.com/ and make sure you're logged in
2. Open your browser's Dev Tools:
   • Firefox: Shift+F9 → Storage tab
   • Chrome: F12 → Application tab → Cookies
3. Find the remember_token cookie for https://www.polarsteps.com
4. Copy the token value

Set your token as an environment variable:

export POLARSTEPS_REMEMBER_TOKEN="your_remember_token_here"

Add this configuration to your Claude Desktop settings:

{
  "mcpServers": {
    "polarsteps": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/remuzel/polarsteps-mcp", "polarsteps-mcp"],
      "env": {
        "POLARSTEPS_REMEMBER_TOKEN": "your_remember_token_here"
      }
    }
  }
}

Once configured, you can ask Claude things like:

• "Show me travel stats for username 'johndoe'"
• "Tell me about johndoe's trip to Japan"
• "What country should johndoe add to their bucketlist?"

Test the MCP server locally with the inspector:

npx @modelcontextprotocol/inspector uvx --from git+https://github.com/remuzel/polarsteps-mcp polarsteps-mcp

For development or manual installation:

# Clone the repository
git clone https://github.com/remuzel/polarsteps-mcp
cd polarsteps-mcp
# Setup development environment
just setup
# or without just:
uv sync --dev && uv pip install -e .

just test

just test-mcp

just lint