About Polarsteps
Polarsteps is an MCP server published by remuzel in the Developer Tools category: an unofficial Polarsteps MCP Server enabling models to interact with the Polarsteps API.
The repository has 2 stars and 2 forks, with the last commit a year ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.
Install
git clone https://github.com/remuzel/polarsteps-mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Ask AI
Ask AI about Polarsteps
Powered by Claude · Grounded in docs
Security checks
Static checks derived from the repository 5 days ago. Heuristics on the source, not an audit.
- ✓README presentThe repository ships documentation.
- ✓License declaredUsable under a stated license.
- ✓Tests presentA test suite exists in the repository.
- ✓Dependencies pinnedA lockfile pins dependency versions.
- ✓No dynamic code executionSource scan found no eval, dynamic Function, or shell execution.
- !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.
README
[!WARNING]
This MCP server uses thepolarsteps-apipackage to access Polarsteps data through undocumented APIs. Important: Please read the associated legal disclaimer and terms of use before using this tool. By using this MCP server, you agree to the terms outlined in the API package and acknowledge the associated risks.
Polarsteps MCP Server
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.
Features
- 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
Quick Start
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.
Configuration
You'll need your Polarsteps remember_token to authenticate API requests.
Getting Your Token
- Go to https://www.polarsteps.com/ and make sure you're logged in
- Open your browser's Dev Tools:
- Firefox: Shift+F9 → Storage tab
- Chrome: F12 → Application tab → Cookies
- Find the
remember_tokencookie for https://www.polarsteps.com - Copy the token value
Setting the Token
Set your token as an environment variable:
export POLARSTEPS_REMEMBER_TOKEN="your_remember_token_here"
Usage
With Claude Desktop
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"
}
}
}
}
Example Queries
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?"
Local Testing
Test the MCP server locally with the inspector:
npx @modelcontextprotocol/inspector uvx --from git+https://github.com/remuzel/polarsteps-mcp polarsteps-mcp
Installation from Source
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 .
Development
Running Tests
just test
Local MCP Testing
just test-mcp
Code Formatting
just lint
README fetched from the repository 5 days ago. The original is authoritative.