Motion

Gestiona tareas y proyectos en Motion usando asistentes de IA.

Documentación

Servidor MCP de Motion

Conecta asistentes de IA a Motion para la gestión de tareas y proyectos.

Instalación

npm install -g @h3ro-dev/motion-mcp-server

Configuración rápida

1. Obtén tu clave de API de Motion

Motion → Configuración → API e integraciones → Crear nueva clave de API

2. Configura

Claude Desktop
{
  "mcpServers": {
    "motion": {
      "command": "npx",
      "args": ["-y", "@h3ro-dev/motion-mcp-server"],
      "env": {
        "MOTION_API_KEY": "your-api-key"
      }
    }
  }
}

Ubicación de la configuración:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
  • Linux: ~/.config/Claude/claude_desktop_config.json
Cursor
{
  "mcpServers": {
    "motion": {
      "command": "npx",
      "args": ["-y", "@h3ro-dev/motion-mcp-server"],
      "env": {
        "MOTION_API_KEY": "your-api-key"
      }
    }
  }
}
VS Code (con Continue)
{
  "mcpServers": {
    "motion": {
      "command": "npx",
      "args": ["-y", "@h3ro-dev/motion-mcp-server"],
      "env": {
        "MOTION_API_KEY": "your-api-key"
      }
    }
  }
}

3. Reinicia tu asistente de IA

Características

  • Todas las APIs de Motion - Tareas, proyectos, espacios de trabajo, usuarios, comentarios, tareas recurrentes, horarios
  • 🚦 Límite de velocidad inteligente - Manejo automático del límite de 12 solicitudes/3 min de Motion
  • 💾 Estado persistente - La base de datos SQLite mantiene los límites de velocidad entre reinicios
  • 🔍 Errores claros - Mensajes útiles para depuración
  • 📝 TypeScript completo - Seguro de tipos y confiable

Ejemplos de uso

"List my tasks"
"Create task: Review budget, due Friday, high priority"
"Move task abc123 to Marketing workspace"
"Add comment to task xyz789: Waiting for approval"
"Create recurring task: Daily standup at 9am"

Referencia de herramientas

Gestión de tareas (7 herramientas)
HerramientaDescripciónEjemplo
motion_list_tasksListar tareas con filtrosworkspaceId, status, assigneeId
motion_get_taskObtener detalles de la tareataskId
motion_create_taskCrear nueva tareaname, workspaceId, dueDate, priority
motion_update_taskActualizar tareataskId, status, priority
motion_delete_taskEliminar tareataskId
motion_move_taskMover al espacio de trabajotaskId, workspaceId
motion_unassign_taskQuitar asignadotaskId
Gestión de proyectos (5 herramientas)
HerramientaDescripciónEjemplo
motion_list_projectsListar proyectosworkspaceId
motion_get_projectObtener detalles del proyectoprojectId
motion_create_projectCrear proyectoname, workspaceId
motion_update_projectActualizar proyectoprojectId, name
motion_archive_projectArchivar proyectoprojectId
Otras herramientas (8 herramientas)
HerramientaDescripción
motion_list_workspacesListar todos los espacios de trabajo
motion_get_workspaceObtener detalles del espacio de trabajo
motion_list_usersListar usuarios del espacio de trabajo
motion_get_current_userObtener usuario actual
motion_list_commentsListar comentarios de tareas
motion_create_commentAgregar comentario a tarea
motion_list_recurring_tasksListar tareas recurrentes
motion_create_recurring_taskCrear tarea recurrente
motion_delete_recurring_taskEliminar tarea recurrente
motion_list_schedulesListar horarios

Configuración

VariableRequeridaPredeterminadoDescripción
MOTION_API_KEY-Tu clave de API de Motion
MOTION_BASE_URLhttps://api.usemotion.com/v1Endpoint de la API
RATE_LIMIT_WINDOW_MS180000Ventana de límite de velocidad (3 min)
RATE_LIMIT_MAX_REQUESTS12Máximo de solicitudes por ventana
DATABASE_PATH./motion-rate-limit.dbRuta de la base de datos SQLite
DEBUGfalseHabilitar registro de depuración

Desarrollo

# Clone
git clone https://github.com/h3ro-dev/motion-mcp-server.git
cd motion-mcp-server

# Install
npm install

# Build
npm run build

# Test
npm test

# Run locally
MOTION_API_KEY=your-key npm start

Solución de problemas

Problemas comunes

"Clave de API no válida"

  • Verifica que la clave de API sea correcta
  • Asegúrate de que no haya espacios adicionales
  • Regenera la clave si es necesario

"Límite de velocidad excedido"

  • El servidor maneja esto automáticamente
  • El tiempo de espera se muestra en el error
  • Verifica que DATABASE_PATH sea escribible

"Tarea no encontrada"

  • Verifica que el ID de la tarea exista
  • Comprueba el acceso al espacio de trabajo
  • La tarea puede estar archivada

Licencia

MIT © h3ro-dev

Enlaces