mcp-samsara
Automation Squad - MCP para Samsara
Integración completa de Samsara Fleet Management para Claude AI
21 herramientas | Conocimiento experto incorporado | Beta
🚀 GRATIS DURANTE LA BETA - ¡Asegura tu descuento de por vida!
⚠️ Aviso Importante
INTEGRACIÓN NO OFICIAL: Este es un servidor MCP de terceros no oficial. Es:
❌ NO afiliado, respaldado o patrocinado por Samsara Inc.
❌ NO es un producto oficial de Samsara
✅ Construido usando la API pública de Samsara con tus propias credenciales API
✅ Totalmente compatible con los términos de servicio de la API de Samsara
Samsara® es una marca registrada de Samsara Inc.
Related MCP server: Samsara Fleet MCP Server
🎯 Qué Hace Esto
Conecta Claude AI a la API de Samsara Fleet Management con:
✅ 21 herramientas en vehículos, rutas, conductores, direcciones, webhooks y contactos
✅ Conocimiento experto integrado en la descripción de cada herramienta
✅ Preservación automática del estado (IDs de paradas, datos de rutas)
✅ Límite de velocidad inteligente (no alcanzará los límites de la API)
✅ Optimización de rutas (algoritmos de eficiencia incorporados)
✅ Mejores prácticas de producción (manejo de errores, reintentos)
Herramientas Incluidas
Gestión de Vehículos (4 herramientas)
Listar vehículos, obtener detalles de vehículos, ubicaciones en tiempo real, estadísticas
Gestión de Rutas (6 herramientas) ⭐ Nuestra especialidad
Crear, actualizar, eliminar rutas
Preservación automática del estado de las paradas (¡crítico para el seguimiento del tiempo!)
Optimización de rutas (minimizar distancia/tiempo)
Listar y obtener detalles de rutas
Gestión de Conductores (4 herramientas)
Listar conductores, obtener detalles de conductores
Seguimiento de cumplimiento de Horas de Servicio (HOS)
Monitoreo de eventos de seguridad
Dirección y Ubicación (2 herramientas)
Crear y gestionar direcciones guardadas
Integración de geocercas
Integración de Webhooks (3 herramientas)
Notificaciones de eventos en tiempo real
Actualizaciones de rutas, eventos de vehículos, etc.
Gestión de Contactos (2 herramientas)
Crear y gestionar contactos para paradas de rutas
🚀 Inicio Rápido
Requisitos Previos
Node.js 18+ instalado
Token de API de Samsara (Consíguelo aquí)
Claude Desktop o cualquier cliente compatible con MCP
Instalación
git clone https://github.com/AutomationSquadOS/mcp-samsara
cd mcp-samsara
npm install
npm run buildNota: el paquete npm
@automation-squad/mcp-samsaraaún no está publicado, por lo que clonar y compilar es la única ruta de instalación que funciona hoy. Cuando se lance, un comando de una línea connpxreemplazará los pasos anteriores.
Configuración
Añade a tu archivo de configuración de Claude Desktop:
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"
}
}
}
}Reemplaza /absolute/path/to/mcp-samsara con la ubicación donde clonaste el repositorio. La ruta debe
ser absoluta — Claude Desktop no resuelve ~ ni rutas relativas.
Clientes de la UE: Usa https://api.eu.samsara.com para SAMSARA_BASE_URL
Reiniciar Claude
Sal y vuelve a abrir Claude Desktop. ¡Deberías ver las herramientas de Samsara disponibles!
💡 Ejemplo de Uso
Crear una ruta con optimización
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:
Creará la ruta con las direcciones adecuadas
Optimizará automáticamente el orden de las paradas
Preservará todos los IDs de paradas para el seguimiento
Asignará vehículo/conductor si se solicita
Rastrear ubicaciones de vehículos
Show me real-time locations for all vehicles currently on routesMonitorear el cumplimiento del conductor
Get HOS logs for driver John Smith for the past week and check for any violations🔥 Qué lo Hace Mejor
vs. Construir Integración Directa con la API
Característica | API Directa | Este MCP |
Tiempo de configuración | Días | Minutos |
Preservación del estado de paradas | Manual | Automática |
Límite de velocidad | Hágalo usted mismo | Incorporado |
Manejo de errores | Personalizado | Probado en producción |
Optimización de rutas | Constrúyalo usted mismo | Incluida |
Mejores prácticas | Investigación necesaria | Incorporadas |
vs. MCP Oficial (si existiera)
Característica | Hipotético Oficial | Automation Squad |
Número de herramientas | ~8-12 básicas | 21 |
Cobertura de API | ~10% | Flota, rutas, conductores, HOS, webhooks |
Conocimiento experto | ❌ | ✅ Incorporado |
Optimización de rutas | ❌ | ✅ Incluida |
Preservación del estado | Manual | Automática |
Actualizaciones | Esporádicas | Continuas |
🛠️ Arquitectura
Límite de Velocidad
5 solicitudes/segundo conservadoras con limitación automática y lógica de reintento.
Manejo de Errores
Reintento automático en 429 (límite de velocidad)
Mensajes de error claros
Degradación gradual
Preservación del Estado
Característica crítica: Al actualizar rutas, automáticamente:
Obtenemos la ruta existente
Extraemos los IDs de las paradas
Los preservamos en las actualizaciones
Evitamos la pérdida de datos
Esta es una mejor práctica que evita perder los tiempos de llegada/salida.
📚 Documentación
Variables de Entorno
Variable | Requerida | Valor por Defecto | Descripción |
| ✅ Sí | - | Tu token de API de Samsara |
| No |
| URL base de la API (usa endpoint UE si es necesario) |
Convención de Nombres de Herramientas
Todas las herramientas tienen el prefijo samsara_ para mayor claridad:
samsara_list_vehiclessamsara_create_routesamsara_get_driver_hosetc.
🤝 Integración con TMS
Usa externalIds en rutas/vehículos/conductores para vincular con tu TMS:
{
"externalIds": {
"tmsOrderId": "ORD-12345",
"customerId": "CUST-789"
}
}Luego consulta por ID externo:
Find the route linked to TMS order ORD-12345🐛 Solución de Problemas
"Error: la variable de entorno SAMSARA_API_TOKEN es obligatoria"
Establece tu token de API en el archivo de configuración de Claude (consulta Configuración más arriba).
"Error de API de Samsara (401): No autorizado"
Tu token de API no es válido o ha caducado. Genera uno nuevo en el panel de Samsara.
"Error de API de Samsara (429): Demasiadas solicitudes"
El MCP reintentará automáticamente. Si ves esto con frecuencia, es posible que tengas otras integraciones accediendo a la API.
Las herramientas no aparecen en Claude
Verifica la sintaxis del archivo de configuración (JSON válido)
Reinicia Claude por completo (salir y volver a abrir)
Revisa los registros de Claude en busca de errores
📦 Qué Está Incluido
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🔐 Seguridad
Tus credenciales se quedan en local - El token de API se almacena en tu máquina
Sin recopilación de datos - No vemos tus datos de Samsara
Código abierto - Revisa el código tú mismo
Sin llamadas a casa - El MCP se ejecuta completamente en local
📈 Hoja de Ruta
Añadir más herramientas (despacho, activos, etiquetas)
Soporte para operaciones por lotes
Algoritmos de optimización mejorados
Optimización de múltiples rutas
Cálculos de costos de combustible
Herramientas de informes de cumplimiento
🎓 Aprende Más
💬 Soporte
Usuarios Beta:
Únete a la comunidad de Automation Squad
Correo electrónico: rob@matrix.digital
Issues de GitHub: Reportar un error
📝 Licencia
Licencia MIT - Consulta el archivo LICENSE para más detalles
🙏 Créditos
Construido con ❤️ por Automation Squad
No afiliado a Samsara Inc. Esta es una integración independiente que utiliza la API pública de Samsara.
⭐ Más de Automation Squad
Documentación, pasos de instalación y qué no hace este servidor: automationsquad.com/mcp/samsara
The AI Five — cinco cosas que vale la pena saber sobre IA y automatización, semanalmente. Suscríbete gratis →
¿Listo para automatizar la gestión de tu flota? ¡Vamos! 🚀
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