tractive-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@tractive-mcp where is my dog right now?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
tractive-mcp
An MCP server for the Tractive GPS pet tracker. Lets AI assistants like Claude query your pet's location, tracker status, position history, and more.
Requirements
Python 3.13+
A Tractive account with at least one GPS tracker
Related MCP server: GC-MCP
Quick Start (from PyPI)
# Authenticate
uvx tractive-mcp auth
# Add to Claude Code
claude mcp add tractive -- uvx tractive-mcpInstall from Source
git clone https://github.com/rexchoppers/tractive-mcp.git
cd tractive-mcp
uv sync
uv run tractive-mcp auth
claude mcp add tractive -- uv run tractive-mcpAuthentication
Tractive does not provide any OAuth mechanisms. As a result, email and passwords have to be stored locally. Run the auth command to save your Tractive credentials:
uvx tractive-mcp authCredentials are stored at ~/.config/tractive-mcp/credentials.json with 0600 permissions.
Usage with Claude Code
claude mcp add tractive -- uvx tractive-mcpUsage with Claude Desktop
Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):
{
"mcpServers": {
"tractive": {
"command": "uvx",
"args": ["tractive-mcp"]
}
}
}Available Tools
Discovery
Tool | Description |
| Lists all pets on the account with their name, type, and device_id |
Location
Tool | Description |
| Current GPS coordinates, speed, altitude, accuracy |
| Distance in metres from the pet's home location |
| Position history with summary stats (distance, bounding box, point count). Set |
Tracker
Tool | Description |
| Battery level, charging state, connection state, firmware |
| Turn the tracker buzzer on/off |
| Turn the tracker LED on/off |
| Toggle live tracking mode (more frequent GPS, more battery) |
Pet Info
Tool | Description |
| Full pet profile — breed, weight, birthday, activity goals |
Emergency
Tool | Description |
| All-in-one emergency tool. Returns location, distance from home, tracker status, and recent activity. Optionally activates live tracking, buzzer, and LED |
Project Structure
src/tractive_mcp/
server.py — MCP server, tool definitions, auth CLI
client.py — Credential management, Tractive client helper
models.py — Response dataclassesLicense
See LICENSE.
Available Tools
10 toolsget_pet_distance_from_homeA
Get how far a pet currently is from its home location.
Args: device_id: The device_id from list_pets.
Returns distance in metres, plus the home and current coordinates.
Inputs: device_id (required).
get_pet_locationA
Get the current GPS location of a pet.
Args: device_id: The device_id from list_pets.
Returns lat, lon, speed, altitude, time, and other position data.
Inputs: device_id (required).
get_pet_profileA
Get the full profile of a pet including breed, weight, birthday, and activity goals.
Args: device_id: The device_id from list_pets.
Inputs: device_id (required).
get_recent_positionsA
Get recent position history (breadcrumb trail) for a pet.
Args: device_id: The device_id from list_pets. hours: How many hours of history to fetch (default 24). include_points: If True, include the full list of position points. Set to False (default) to save context when you only need stats.
Returns a summary with point count, total distance, time range, and bounding box. If include_points is True, also returns the points array.
Inputs: device_id (required), hours, include_points.
get_tracker_statusA
Get the status of a Tractive GPS tracker.
Args: device_id: The device_id from list_pets.
Returns battery level, charging state, connection state, and hardware info.
Inputs: device_id (required).
list_petsA
List all pets on the user's Tractive account.
Returns each pet's id, name, pet type (dog/cat), and assigned tracker id. Use the pet's id when calling other tools like get_pet_location.
Inputs: no named parameters. Returns: result
lost_petA
Emergency tool — call when a pet is lost or missing.
Gathers all critical info in one call: current location, distance from home, tracker battery/connection status, and recent movement summary. Can activate live tracking, buzzer, and LED on the tracker.
Args: device_id: The device_id from list_pets. enable_live_tracking: Turn on live tracking for frequent GPS updates (default True). enable_buzzer: Turn on the tracker buzzer to help locate the pet nearby (default False). enable_led: Turn on the tracker LED light (default False).
Inputs: device_id (required), enable_live_tracking, enable_buzzer, enable_led.
set_buzzerA
Turn the tracker buzzer on or off.
Args: device_id: The device_id from list_pets. active: True to turn on, False to turn off.
Inputs: device_id (required), active (required).
set_ledA
Turn the tracker LED light on or off.
Args: device_id: The device_id from list_pets. active: True to turn on, False to turn off.
Inputs: device_id (required), active (required).
set_live_trackingA
Turn live tracking mode on or off. Live tracking gives more frequent GPS updates but uses more battery.
Args: device_id: The device_id from list_pets. active: True to turn on, False to turn off.
Inputs: device_id (required), active (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 10 tools
Every tool has a clearly distinct purpose: listing pets, retrieving location, distance, profile, history, status, emergency info, and controlling buzzer/LED/live tracking. No two tools overlap in functionality.
Most tools follow a consistent verb_noun pattern (e.g., list_pets, get_pet_location, set_buzzer). The 'lost_pet' tool uses an imperative verb without underscore but is still clear and fits the domain's emergency context.
10 tools is an appropriate number for a pet tracking server. Each tool serves a necessary function without excess, covering core operations like retrieving location, history, status, and controlling tracker features.
The tool set covers the full lifecycle for pet tracking: listing pets, retrieving location, distance, history, profile, tracker status, and toggling live tracking/buzzer/LED. The lost_pet tool bundles critical info for emergencies. No obvious gaps for the domain.
Maintenance
Related MCP Connectors
Give any AI assistant real-time access to your phone's GPS and location history.
Read pet activity and weight history, and log events with your permission.
Control your Tesla from your AI assistant - climate, charging, access, and security.
Connects AI assistants to TrackingTime for querying time entries, projects, tasks, customers, and team data using natural language.
Related MCP Servers
- AlicenseBqualityDmaintenanceEnables users to interact with their Strava data through natural language to analyze workouts, track fitness progress, and explore routes. It supports retrieving detailed activity stats, heart rate data, and segment insights directly within AI assistants.26MIT
- FlicenseNot gradedqualityCmaintenanceEnables AI assistants to access and query Garmin Connect health and fitness data, including sleep, HRV, training load, and activities, with an optional coaching plugin for personalized training plans.4-
- AlicenseAqualityDmaintenanceEnables AI assistants to directly access and analyze Strava activity data, including runs, rides, and swims, through natural language queries.414 npmMIT
- AlicenseNot gradedqualityCmaintenanceEnables AI assistants to query live Garmin Connect health and fitness data, including daily metrics, activities, sleep analysis, and trends via natural language.MIT