Motion
Gestiona tareas y proyectos en Motion usando asistentes de IA.
GitHub
2
Prueba este MCPPatrocinadoDocumentació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)
| Herramienta | Descripción | Ejemplo |
|---|---|---|
motion_list_tasks | Listar tareas con filtros | workspaceId, status, assigneeId |
motion_get_task | Obtener detalles de la tarea | taskId |
motion_create_task | Crear nueva tarea | name, workspaceId, dueDate, priority |
motion_update_task | Actualizar tarea | taskId, status, priority |
motion_delete_task | Eliminar tarea | taskId |
motion_move_task | Mover al espacio de trabajo | taskId, workspaceId |
motion_unassign_task | Quitar asignado | taskId |
Gestión de proyectos (5 herramientas)
| Herramienta | Descripción | Ejemplo |
|---|---|---|
motion_list_projects | Listar proyectos | workspaceId |
motion_get_project | Obtener detalles del proyecto | projectId |
motion_create_project | Crear proyecto | name, workspaceId |
motion_update_project | Actualizar proyecto | projectId, name |
motion_archive_project | Archivar proyecto | projectId |
Otras herramientas (8 herramientas)
| Herramienta | Descripción |
|---|---|
motion_list_workspaces | Listar todos los espacios de trabajo |
motion_get_workspace | Obtener detalles del espacio de trabajo |
motion_list_users | Listar usuarios del espacio de trabajo |
motion_get_current_user | Obtener usuario actual |
motion_list_comments | Listar comentarios de tareas |
motion_create_comment | Agregar comentario a tarea |
motion_list_recurring_tasks | Listar tareas recurrentes |
motion_create_recurring_task | Crear tarea recurrente |
motion_delete_recurring_task | Eliminar tarea recurrente |
motion_list_schedules | Listar horarios |
Configuración
| Variable | Requerida | Predeterminado | Descripción |
|---|---|---|---|
MOTION_API_KEY | ✅ | - | Tu clave de API de Motion |
MOTION_BASE_URL | ❌ | https://api.usemotion.com/v1 | Endpoint de la API |
RATE_LIMIT_WINDOW_MS | ❌ | 180000 | Ventana de límite de velocidad (3 min) |
RATE_LIMIT_MAX_REQUESTS | ❌ | 12 | Máximo de solicitudes por ventana |
DATABASE_PATH | ❌ | ./motion-rate-limit.db | Ruta de la base de datos SQLite |
DEBUG | ❌ | false | Habilitar 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_PATHsea 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