Samsara fleet management — vehicles, routes, drivers, HOS compliance. Unofficial, bring your token.
Complete Samsara Fleet Management integration for Claude AI
21 tools | Expert knowledge built-in | Beta
UNOFFICIAL INTEGRATION: This is an unofficial third-party MCP server. It is:
Samsara® is a registered trademark of Samsara Inc.
See NOTICE for the full third-party disclaimer. Licence: MIT.
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)
Vehicle Management (4 tools)
Route Management (6 tools) ⭐ Our specialty
Driver Management (4 tools)
Address & Location (2 tools)
Webhook Integration (3 tools)
Contact Management (2 tools)
git clone https://github.com/AutomationSquadOS/mcp-samsara
cd mcp-samsara
npm install
npm run build
Note: the npm package
@automationsquad/mcp-samsarais not published yet, so clone-and-build is the only install path that works today. When it ships, annpxone-liner will replace the steps above.
Add to your Claude Desktop config file:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"samsara": {
"command": "node",
"args": ["/absolute/path/to/mcp-samsara/build/index.js"],
"env": {
"SAMSARA_API_TOKEN": "your-api-token-here",
"SAMSARA_BASE_URL": "https://api.samsara.com"
}
}
}
}
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
Quit and reopen Claude Desktop. You should see the Samsara tools available!
Create a delivery route called "Morning Zone 1" with these stops:
1. Warehouse: 123 Main St, Springfield
2. Customer A: 456 Oak Ave, Springfield
3. Customer B: 789 Pine Rd, Springfield
4. Return to warehouse
Then optimize it for minimum distance.
Claude will:
Show me real-time locations for all vehicles currently on routes
Get HOS logs for driver John Smith for the past week and check for any violations
| 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 |
| Feature | Hypothetical Official | Automation Squad |
|---|---|---|
| Tool count | ~8-12 basic | 21 |
| API coverage | ~10% | Fleet, routes, drivers, HOS, webhooks |
| Expert knowledge | ❌ | ✅ Built-in |
| Route optimization | ❌ | ✅ Included |
| State preservation | Manual | Automatic |
| Updates | Sporadic | Continuous |
Conservative 5 requests/second with automatic throttling and retry logic.
Critical feature: When updating routes, we automatically:
This is a best practice that prevents losing arrival/departure times.
| Variable | Required | Default | Description |
|---|---|---|---|
SAMSARA_API_TOKEN | ✅ Yes | - | Your Samsara API token |
SAMSARA_BASE_URL | No | https://api.samsara.com | API base URL (use EU endpoint if needed) |
All tools are prefixed with samsara_ for clarity:
samsara_list_vehiclessamsara_create_routesamsara_get_driver_hosUse externalIds in routes/vehicles/drivers to link with your TMS:
{
"externalIds": {
"tmsOrderId": "ORD-12345",
"customerId": "CUST-789"
}
}
Then query by external ID:
Find the route linked to TMS order ORD-12345
Set your API token in the Claude config file (see Configuration above).
Your API token is invalid or expired. Generate a new one in Samsara dashboard.
The MCP will automatically retry. If you see this often, you may have other integrations hitting the API.
mcp-samsara/
├── src/
│ └── index.ts # Main MCP server
├── build/ # Compiled JavaScript
├── package.json # NPM package config
├── tsconfig.json # TypeScript config
├── README.md # This file
└── LICENSE # MIT License
Beta Users:
MIT License - See LICENSE file for details
Built with ❤️ by Automation Squad
Not affiliated with Samsara Inc. This is an independent integration using Samsara's public API.
Docs, install steps and what this server does not do: automationsquad.com/mcp/samsara
The AI Five — five things worth knowing about AI and automation, weekly. Subscribe free →
Ready to automate your fleet management? Let's go! 🚀
This listing does not have a supported local package template. Use the maintainer’s documentation for its hosted endpoint, authentication, and client-specific setup. No install command has been inferred.