AutomationSquadOS/mcp-samsara

> **Complete Samsara Fleet Management integration for Claude AI**
> 21 tools | Expert knowledge built-in | Beta
---
⚠️ Important Disclaimer
**UNOFFICIAL INTEGRATION:** This is an **unofficial** third-party MCP server. It is:
- ❌ **NOT** affiliated with, endorsed by, or sponsored by Samsara Inc.
- ❌ **NOT** an official Samsara product
- ✅ Built using Samsara's **public API** with your own API credentials
- ✅ Fully compliant with Samsara's API terms of service
**Samsara®** is a registered trademark of Samsara Inc.
See NOTICE for the full third-party disclaimer. Licence: MIT.
---
🎯 What This Does
Connects Claude AI to the Samsara Fleet Management API with:
✅ **21 tools** across vehicles, routes, drivers, addresses, webhooks and contacts
✅ **Expert knowledge** built into every tool description
✅ **Automatic state preservation** (stop IDs, route data)
✅ **Smart rate limiting** (won't hit API limits)
✅ **Route optimization** (built-in efficiency algorithms)
✅ **Production best practices** (error handling, retries)
Tools Included
**Vehicle Management (4 tools)**
- List vehicles, get vehicle details, real-time locations, statistics
**Route Management (6 tools)** ⭐ *Our specialty*
- Create, update, delete routes
- **Auto-preserve stop state** (critical for time tracking!)
- **Route optimization** (minimize distance/time)
- List and get route details
**Driver Management (4 tools)**
- List drivers, get driver details
- Hours of Service (HOS) compliance tracking
- Safety event monitoring
**Address & Location (2 tools)**
- Create and manage saved addresses
- Geofence integration
**Webhook Integration (3 tools)**
- Real-time event notifications
- Route updates, vehicle events, etc.
**Contact Management (2 tools)**
- Create and manage contacts for route stops
---
🚀 Quick Start
Prerequisites
- **Node.js 18+** installed
- **Samsara API Token** (Get one here)
- **Claude Desktop** or any MCP-compatible client
Installation
> **Note:** the npm package @automationsquad/mcp-samsara is not published yet, so
> clone-and-build is the only install path that works today. When it ships, an npx
> one-liner will replace the steps above.
Configuration
Add to your Claude Desktop config file:
**macOS:** ~/Library/Application Support/Claude/claude_desktop_config.json
**Windows:** %APPDATA%\Claude\claude_desktop_config.json
Replace /absolute/path/to/mcp-samsara with wherever you cloned the repo. The path must
be absolute — Claude Desktop does not resolve ~ or relative paths.
**EU customers:** Use https://api.eu.samsara.com for SAMSARA_BASE_URL
Restart Claude
Quit and reopen Claude Desktop. You should see the Samsara tools available!
---
💡 Example Usage
Create a route with optimization
Claude will:
1. Create the route with proper addresses
2. Automatically optimize stop order
3. Preserve all stop IDs for tracking
4. Assign vehicle/driver if requested
Track vehicle locations
Monitor driver compliance
---
🔥 What Makes This Better
vs. Building Direct API Integration
| Feature | Direct API | This MCP |
|---------|-----------|----------|
| Setup time | Days | Minutes |
| Stop state preservation | Manual | Automatic |
| Rate limiting | DIY | Built-in |
| Error handling | Custom | Production-tested |
| Route optimization | Build yourself | Included |
| Best practices | Research needed | Built-in |