Skip to main content
Glama

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+

  • uv

  • 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-mcp

Install 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-mcp

Authentication

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 auth

Credentials are stored at ~/.config/tractive-mcp/credentials.json with 0600 permissions.

Usage with Claude Code

claude mcp add tractive -- uvx tractive-mcp

Usage 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

list_pets

Lists all pets on the account with their name, type, and device_id

Location

Tool

Description

get_pet_location(device_id)

Current GPS coordinates, speed, altitude, accuracy

get_pet_distance_from_home(device_id)

Distance in metres from the pet's home location

get_recent_positions(device_id, hours, include_points)

Position history with summary stats (distance, bounding box, point count). Set include_points=True for the full breadcrumb trail

Tracker

Tool

Description

get_tracker_status(device_id)

Battery level, charging state, connection state, firmware

set_buzzer(device_id, active)

Turn the tracker buzzer on/off

set_led(device_id, active)

Turn the tracker LED on/off

set_live_tracking(device_id, active)

Toggle live tracking mode (more frequent GPS, more battery)

Pet Info

Tool

Description

get_pet_profile(device_id)

Full pet profile — breed, weight, birthday, activity goals

Emergency

Tool

Description

lost_pet(device_id, enable_live_tracking, enable_buzzer, enable_led)

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 dataclasses

License

See LICENSE.

Available Tools

10 tools
get_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

    A4.1/5.0

    Scored across 10 tools

    Disambiguation5/5

    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.

    Naming Consistency4/5

    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.

    Tool Count5/5

    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.

    Completeness5/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      Enables 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.
      26
      MIT
    • F
      license
      Not graded
      quality
      C
      maintenance
      Enables 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
      -
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI assistants to query live Garmin Connect health and fitness data, including daily metrics, activities, sleep analysis, and trends via natural language.
      MIT