mcp-samsara
Automation Squad - MCP für Samsara
Komplette Samsara Flottenmanagement-Integration für Claude AI
21 Tools | Expertenwissen integriert | Beta
🚀 KOSTENLOS WÄHREND DER BETA - Sichern Sie sich Ihren lebenslangen Rabatt!
⚠️ Wichtiger Haftungsausschluss
INOFFIZIELLE INTEGRATION: Dies ist ein inoffizieller MCP-Server eines Drittanbieters. Er ist:
❌ NICHT verbunden mit, unterstützt von oder gesponsert von Samsara Inc.
❌ KEIN offizielles Samsara-Produkt
✅ Erstellt unter Verwendung der öffentlichen API von Samsara mit Ihren eigenen API-Anmeldedaten
✅ Vollständig konform mit den API-Nutzungsbedingungen von Samsara
Samsara® ist eine eingetragene Marke von Samsara Inc.
Related MCP server: Samsara Fleet MCP Server
🎯 Was dies tut
Verbindet Claude AI mit der Samsara Flottenmanagement-API mit:
✅ 21 Tools für Fahrzeuge, Routen, Fahrer, Adressen, Webhooks und Kontakte
✅ Expertenwissen in jede Tool-Beschreibung integriert
✅ Automatische Zustandserhaltung (Stopp-IDs, Routendaten)
✅ Intelligentes Rate-Limiting (erreicht keine API-Limits)
✅ Routenoptimierung (integrierte Effizienzalgorithmen)
✅ Best Practices für die Produktion (Fehlerbehandlung, Wiederholungen)
Enthaltene Tools
Fahrzeugverwaltung (4 Tools)
Fahrzeuge auflisten, Fahrzeugdetails abrufen, Echtzeit-Standorte, Statistiken
Routenverwaltung (6 Tools) ⭐ Unsere Spezialität
Routen erstellen, aktualisieren, löschen
Automatische Stopp-Zustandserhaltung (entscheidend für Zeiterfassung!)
Routenoptimierung (Distanz/Zeit minimieren)
Routendetails auflisten und abrufen
Fahrerverwaltung (4 Tools)
Fahrer auflisten, Fahrerdetails abrufen
Überwachung der Einhaltung der Lenk- und Ruhezeiten (HOS)
Sicherheitsereignis-Überwachung
Adress- & Standortverwaltung (2 Tools)
Gespeicherte Adressen erstellen und verwalten
Geofence-Integration
Webhook-Integration (3 Tools)
Echtzeit-Benachrichtigungen über Ereignisse
Routenaktualisierungen, Fahrzeugereignisse usw.
Kontaktverwaltung (2 Tools)
Kontakte für Routenstopps erstellen und verwalten
🚀 Schnellstart
Voraussetzungen
Node.js 18+ installiert
Samsara API-Token (Hier erhalten)
Claude Desktop oder ein MCP-kompatibler Client
Installation
git clone https://github.com/AutomationSquadOS/mcp-samsara
cd mcp-samsara
npm install
npm run buildHinweis: Das npm-Paket
@automation-squad/mcp-samsaraist noch nicht veröffentlicht, daher ist der Klon-und-Build-Pfad derzeit der einzige Installationsweg. Wenn es veröffentlicht wird, wird einnpx-Einzeiler die obigen Schritte ersetzen.
Konfiguration
Fügen Sie zu Ihrer Claude Desktop-Konfigurationsdatei hinzu:
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"
}
}
}
}Ersetzen Sie /absolute/path/to/mcp-samsara durch den Pfad, in den Sie das Repository geklont haben. Der Pfad muss
absolut sein – Claude Desktop löst ~ oder relative Pfade nicht auf.
EU-Kunden: Verwenden Sie https://api.eu.samsara.com für SAMSARA_BASE_URL
Claude neu starten
Beenden Sie Claude Desktop und öffnen Sie es erneut. Die Samsara-Tools sollten nun verfügbar sein!
💡 Beispielnutzung
Route mit Optimierung erstellen
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 wird:
Die Route mit den richtigen Adressen erstellen
Die Stopp-Reihenfolge automatisch optimieren
Alle Stopp-IDs für die Nachverfolgung erhalten
Fahrzeug/Fahrer zuweisen, falls gewünscht
Fahrzeugstandorte verfolgen
Show me real-time locations for all vehicles currently on routesFahrer-Compliance überwachen
Get HOS logs for driver John Smith for the past week and check for any violations🔥 Was dies besser macht
vs. Direkte API-Integration
Funktion | Direkte API | Dieser MCP |
Einrichtungszeit | Tage | Minuten |
Stopp-Zustandserhaltung | Manuell | Automatisch |
Rate-Limiting | Selbst gemacht | Integriert |
Fehlerbehandlung | Benutzerdefiniert | Produktionsgetestet |
Routenoptimierung | Selbst bauen | Enthalten |
Best Practices | Recherche nötig | Integriert |
vs. Offizieller MCP (falls vorhanden)
Funktion | Hypothetisch offiziell | Automation Squad |
Anzahl Tools | ~8-12 grundlegende | 21 |
API-Abdeckung | ~10% | Flotte, Routen, Fahrer, HOS, Webhooks |
Expertenwissen | ❌ | ✅ Integriert |
Routenoptimierung | ❌ | ✅ Enthalten |
Zustandserhaltung | Manuell | Automatisch |
Aktualisierungen | Sporadisch | Kontinuierlich |
🛠️ Architektur
Rate-Limiting
Konservative 5 Anfragen/Sekunde mit automatischer Drosselung und Wiederholungslogik.
Fehlerbehandlung
Automatische Wiederholung bei 429 (Rate-Limit)
Klare Fehlermeldungen
Graceful Degradation
Zustandserhaltung
Kritisches Feature: Beim Aktualisieren von Routen werden automatisch:
Bestehende Route abgerufen
Stopp-IDs extrahiert
Diese bei Aktualisierungen erhalten
Datenverlust verhindert
Dies ist eine Best Practice, die den Verlust von Ankunfts-/Abfahrtszeiten verhindert.
📚 Dokumentation
Umgebungsvariablen
Variable | Erforderlich | Standard | Beschreibung |
| ✅ Ja | - | Ihr Samsara API-Token |
| Nein |
| API-Basis-URL (bei Bedarf EU-Endpunkt) |
Tool-Namenskonvention
Alle Tools sind zur Klarheit mit samsara_ präfigiert:
samsara_list_vehiclessamsara_create_routesamsara_get_driver_hosusw.
🤝 TMS-Integration
Verwenden Sie externalIds in Routen/Fahrzeugen/Fahrern, um eine Verbindung zu Ihrem TMS herzustellen:
{
"externalIds": {
"tmsOrderId": "ORD-12345",
"customerId": "CUST-789"
}
}Dann nach externer ID abfragen:
Find the route linked to TMS order ORD-12345🐛 Fehlerbehebung
"Fehler: SAMSARA_API_TOKEN Umgebungsvariable ist erforderlich"
Setzen Sie Ihren API-Token in der Claude-Konfigurationsdatei (siehe Konfiguration oben).
"Samsara API-Fehler (401): Nicht autorisiert"
Ihr API-Token ist ungültig oder abgelaufen. Generieren Sie einen neuen im Samsara-Dashboard.
"Samsara API-Fehler (429): Zu viele Anfragen"
Der MCP wird automatisch wiederholen. Wenn Sie dies häufig sehen, haben Sie möglicherweise andere Integrationen, die auf die API zugreifen.
Tools werden in Claude nicht angezeigt
Überprüfen Sie die Syntax der Konfigurationsdatei (gültiges JSON)
Starten Sie Claude vollständig neu (beenden und erneut öffnen)
Überprüfen Sie die Claude-Protokolle auf Fehler
📦 Was ist enthalten
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🔐 Sicherheit
Ihre Anmeldedaten bleiben lokal - API-Token wird auf Ihrem Rechner gespeichert
Keine Datenerfassung - Wir sehen Ihre Samsara-Daten nicht
Open Source - Überprüfen Sie den Code selbst
Kein Phone-Home - MCP läuft vollständig lokal
📈 Fahrplan
Weitere Tools hinzufügen (Disposition, Assets, Tags)
Unterstützung für Batch-Operationen
Verbesserte Optimierungsalgorithmen
Multi-Routen-Optimierung
Kraftstoffkostenberechnungen
Compliance-Berichtstools
🎓 Mehr erfahren
💬 Support
Beta-Benutzer:
Treten Sie der Automation Squad Community bei
E-Mail: rob@matrix.digital
GitHub Issues: Einen Fehler melden
📝 Lizenz
MIT-Lizenz - Siehe LICENSE-Datei für Details
🙏 Danksagungen
Erstellt mit ❤️ von Automation Squad
Nicht verbunden mit Samsara Inc. Dies ist eine unabhängige Integration unter Verwendung der öffentlichen API von Samsara.
⭐ Mehr von Automation Squad
Dokumentation, Installationsschritte und was dieser Server nicht tut: automationsquad.com/mcp/samsara
The AI Five — fünf wissenswerte Dinge über KI und Automatisierung, wöchentlich. Kostenlos abonnieren →
Bereit, Ihr Flottenmanagement zu automatisieren? Los geht's! 🚀
Available Tools
21 toolssamsara_create_addressC
Create a saved address/location in Samsara for reuse in routes
Inputs: name (required), latitude, longitude, externalIds, +1 more.
samsara_create_contactC
Create a contact (person at a stop location) for route management
Inputs: firstName (required), email, phone, lastName, +1 more.
samsara_create_routeA
Create a new route with stops. IMPORTANT: Each stop needs address (with lat/long or formatted address), optional arrival/departure times, and names. Use externalIds to link with your TMS.
Inputs: name (required), stops (required), driverId, startTime, +2 more.
samsara_create_webhookB
Create a webhook to receive real-time notifications from Samsara (route updates, vehicle events, etc.)
Inputs: url (required), eventTypes (required), secret.
samsara_delete_routeC
Delete a route permanently
Inputs: routeId (required).
samsara_delete_webhookC
Delete a webhook subscription
Inputs: webhookId (required).
samsara_get_driverC
Get detailed information about a specific driver
Inputs: driverId (required).
samsara_get_driver_hosC
Get Hours of Service (HOS) logs for a driver. Essential for compliance tracking.
Inputs: endTime (required), driverId (required), startTime (required).
samsara_get_driver_safety_eventsC
Get safety events (harsh braking, acceleration, speeding, etc.) for a driver
Inputs: endTime (required), driverId (required), startTime (required).
samsara_get_routeA
Get detailed information about a specific route including all stops, assigned vehicle/driver, and status
Inputs: routeId (required).
samsara_get_vehicleB
Get detailed information about a specific vehicle by ID
Inputs: vehicleId (required).
samsara_get_vehicle_locationsA
Get real-time or recent locations for vehicles. Uses the feed API pattern for efficient streaming of location data.
Inputs: after, vehicleIds.
samsara_get_vehicle_statsB
Get vehicle statistics including odometer, engine hours, and fuel usage over a time range
Inputs: endTime (required), startTime (required), vehicleIds (required).
samsara_list_addressesB
List all saved addresses
Inputs: after, limit.
samsara_list_contactsD
List all contacts
Inputs: limit.
samsara_list_driversC
List all drivers in the organization with their details and external IDs
Inputs: after, limit.
samsara_list_routesA
List all routes. Routes contain ordered stops with addresses, times, and status tracking.
Inputs: after, limit.
samsara_list_vehiclesA
List all vehicles in the fleet. Returns vehicle details including ID, name, VIN, make, model, and external IDs for TMS integration.
Inputs: after, limit.
samsara_list_webhooksB
List all configured webhooks
Inputs: no named parameters.
samsara_optimize_routeB
Optimize route stop order to minimize distance/time. This is a value-add feature that reorders stops for efficiency while preserving all stop data and IDs.
Inputs: routeId (required), optimizationGoal.
samsara_update_routeA
Update a route. CRITICAL BEST PRACTICE: This tool automatically preserves stop IDs to maintain arrival/departure time tracking. You can update name, vehicle, driver, status, or modify stops. When updating stops, the tool fetches existing stop IDs and preserves them.
Inputs: routeId (required), name, stops, status, +2 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 21 tools
Most tools have distinct purposes (vehicles, routes, drivers, addresses, webhooks, contacts). However, samsara_list_vehicles and samsara_get_vehicle could be confused by an agent as simply different granularities of the same resource, which is acceptable. No major overlapping ambiguity.
All tools follow a consistent samsara_{verb}_{noun} pattern with clear CRUD verbs (list, get, create, update, delete) and one value-add verb (optimize). The naming is predictable and uniform, making it easy for an agent to infer tool purpose.
21 tools covers a fleet management domain (vehicles, routes, drivers, HOS, safety, addresses, webhooks, contacts) reasonably well. It is on the higher side but each tool serves a clear function. Slightly over 15 but not excessive for the scope.
The toolset provides good CRUD coverage for routes, addresses, webhooks, and contacts, plus read-only access for vehicles and drivers with HOS and safety. Missing update/delete for drivers and vehicles, and no update for addresses/contacts, but the core fleet workflows (routing, driver monitoring) are well-covered.
Maintenance
Related MCP Connectors
Tesla Fleet API for AI: send navigation destinations, read battery and location, run car commands.
AI for your car: check charge, start climate, lock/unlock, open trunk via Tesla Fleet API. OAuth.
Read-only access to your Drivara fleet — jobs, drivers, vehicles, fuel, profit & analytics.
Plan last-mile deliveries from your AI assistant. Turns orders from spreadsheets, URLs, or pasted text into optimized delivery routes. It geocodes addresses, flags locations that need confirmation, and assigns stops across your fleet while respecting vehicle capacity, delivery time windows, and stop limits. Manage vehicles and depots, review route maps, and plan anything from a small delivery run to thousands of stops. Connect with your Vepathos account using OAuth.
Related MCP Servers
- FlicenseAqualityCmaintenanceEnables AI agents to query orders, manage routes, track drivers, and analyze delivery performance on the FleetSync last-mile delivery platform through natural language.18-
- FlicenseNot gradedqualityCmaintenanceExposes live Samsara fleet data via MCP tools for searching assets and retrieving GPS locations.-
- AlicenseNot gradedqualityCmaintenanceIntegrates with Tesla Fleet API and TeslaMate API to control vehicles, monitor energy (Powerwall/Solar), manage charging, and analyze driving data, with generative UI and skill workflows.5MIT
- AlicenseNot gradedqualityBmaintenanceProvides real-time freight tracking and load visibility for logistics and AI agents: create loads, get live GPS positions, trip stats, and confirm deliveries via geofenced statuses.1MIT