Skip to main content
Glama

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 build

Nota: el paquete npm @automation-squad/mcp-samsara aú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 con npx reemplazará 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:

  1. Creará la ruta con las direcciones adecuadas

  2. Optimizará automáticamente el orden de las paradas

  3. Preservará todos los IDs de paradas para el seguimiento

  4. Asignará vehículo/conductor si se solicita

Rastrear ubicaciones de vehículos

Show me real-time locations for all vehicles currently on routes

Monitorear 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:

  1. Obtenemos la ruta existente

  2. Extraemos los IDs de las paradas

  3. Los preservamos en las actualizaciones

  4. 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

SAMSARA_API_TOKEN

✅ Sí

-

Tu token de API de Samsara

SAMSARA_BASE_URL

No

https://api.samsara.com

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_vehicles

  • samsara_create_route

  • samsara_get_driver_hos

  • etc.


🤝 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

  1. Verifica la sintaxis del archivo de configuración (JSON válido)

  2. Reinicia Claude por completo (salir y volver a abrir)

  3. 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:


📝 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 tools
samsara_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

    B3.1/5.0

    Scored across 21 tools

    Disambiguation4/5

    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.

    Naming Consistency5/5

    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.

    Tool Count4/5

    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.

    Completeness4/5

    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

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers