tractive-mcp
Enables AI assistants to query your pet's location, tracker status, position history, and more via the Tractive GPS pet tracker.
README
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
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.
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
Audiense Insights MCP Server
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
graphlit-mcp-server
The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.
Kagi MCP Server
An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.
E2B
Using MCP to run code via e2b.
Neon Database
MCP server for interacting with Neon Management API and databases
Exa Search
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.