Motion MCP Server

Motion es una aplicación de calendario y gestión de tareas impulsada por IA que programa automáticamente tu trabajo. Este servidor MCP conecta la API de Motion con LLMs como Claude y ChatGPT a través del Model Context Protocol, para que puedas gestionar tareas, buscar proyectos, consultar tu agenda y más, todo mediante conversación natural. Funciona en escritorio, web y móvil.

Vista previa

Haz clic en la imagen para verla a tamaño completo

Related MCP server: Motion MCP Server

Primeros pasos

Requisitos previos: Node.js 20+ y una clave de API de Motion.

Configuración local (npx)

Para clientes MCP de escritorio: Claude Desktop, Claude Code, Cursor y similares.

Añade a tu claude_desktop_config.json:

{
  "mcpServers": {
    "motion": {
      "command": "npx",
      "args": ["motionmcp"],
      "env": {
        "MOTION_API_KEY": "your_api_key"
      }
    }
  }
}

Prueba desde la línea de comandos:

MOTION_API_KEY=your_api_key npx motionmcp

Consejo: npx siempre ejecuta la última versión publicada; no es necesario instalar nada.

Configuración remota (Cloudflare Workers)

Para clientes móviles y web: Claude móvil/web, ChatGPT móvil/web o cualquier cliente MCP HTTP.

Despliegue con un clic

Tras el despliegue, configura tus secretos en el panel de Cloudflare (Workers > tu worker > Settings > Variables):

• MOTION_API_KEY — tu clave de API de Motion

• MOTION_MCP_SECRET — una cadena aleatoria (genérala con openssl rand -hex 16)

Despliegue manual

# Set secrets
npx wrangler secret put MOTION_API_KEY
npx wrangler secret put MOTION_MCP_SECRET   # use: openssl rand -hex 16

# Deploy
npm run worker:deploy

Tu URL MCP será:

https://motion-mcp-server.YOUR_SUBDOMAIN.workers.dev/mcp/YOUR_SECRET

Usa exactamente esa dirección. El secreto va al final de la ruta y nada lo sigue: el servidor anuncia sus propias sub-rutas (como el endpoint de mensajes) durante una sesión, así que no añadas /sse ni ninguna otra sub-ruta al secreto.

Conexión desde Claude

1. Ve a claude.ai > Settings > Connectors

2. Añade tu URL MCP

3. El servidor se sincroniza automáticamente con la aplicación móvil de Claude

Conexión desde ChatGPT

1. Ve a ChatGPT Settings > Connectors

2. Añade tu URL MCP

Seguridad: El secreto en la URL evita el descubrimiento casual. Trata la URL completa como una contraseña: no la compartas públicamente.

La configuración de herramientas funciona igual que en el servidor local. Establece MOTION_MCP_TOOLS en wrangler.toml bajo [vars], o sobrescríbelo mediante wrangler secret put MOTION_MCP_TOOLS.

Para el desarrollo local de Workers, consulta DEVELOPER.md.

Clave de API

El servidor lee tu clave de API de Motion desde la variable de entorno MOTION_API_KEY.

En línea (npx):

MOTION_API_KEY=your-key npx motionmcp

Archivo .env (cuando se ejecuta desde el código fuente mediante npm):

MOTION_API_KEY=your-key

Cuando uses npx, prefiere la variable de entorno en línea, ya que npx no leerá un archivo .env local.

Configuración de herramientas

Las 10 herramientas están habilitadas por defecto. Si ejecutas varios servidores MCP y quieres reducir el ruido de selección de herramientas, puedes limitar cuáles se exponen mediante la variable de entorno MOTION_MCP_TOOLS:

Ejemplo personalizado:

MOTION_MCP_TOOLS=custom:motion_tasks,motion_projects,motion_search npx motionmcp

Referencia de herramientas

motion_tasks

Operaciones: create, list, list_all_uncompleted, get, update, delete, move, unassign

La herramienta principal para la gestión de tareas. Admite todos los parámetros de la API de Motion, incluidos name, description, priority, dueDate, duration, labels, assigneeId y autoScheduled. Puedes referenciar espacios de trabajo y proyectos por nombre; el servidor los resuelve automáticamente.

list_all_uncompleted abarca todos los espacios de trabajo en una sola llamada (ignora workspaceId/workspaceName) y respeta los filtros dueDate y priority, de modo que "¿qué vence esta semana en todos mis espacios de trabajo?" se resuelve directamente. En list, dueDate es un límite inclusivo de "en o antes de ese día" que incluye tareas vencidas (así que dueDate: "today" responde a "¿qué vence hoy?"), y completedAfter / completedBefore acotan por fecha de finalización en la zona horaria de tu cuenta para "¿qué hice esta semana?". Las fechas se interpretan en la zona horaria de tu cuenta de Motion, y las respuestas de listado comienzan con un encabezado que indica esa zona y la fecha local de hoy.

{
  "operation": "create",
  "name": "Complete API integration",
  "workspaceName": "Development",
  "projectName": "Release Cycle Q2",
  "dueDate": "2025-06-15T09:00:00Z",
  "priority": "HIGH",
  "labels": ["api", "release"]
}

motion_projects

Operaciones: create, list, get

Gestiona proyectos de Motion. Los nombres de espacios de trabajo y proyectos se comparan de forma difusa, y el servidor selecciona automáticamente tu espacio de trabajo "Personal" si no se especifica ninguno.

{"operation": "create", "name": "New Project", "workspaceName": "Personal"}

motion_workspaces

Operaciones: list, get

Lista e inspecciona espacios de trabajo.

motion_users

Operaciones: list, current

Lista usuarios en un espacio de trabajo u obtiene el usuario autenticado actual.

motion_search

Operaciones: content

Busca tareas y proyectos por consulta en un espacio de trabajo.

{"operation": "content", "query": "API integration", "workspaceName": "Development"}

motion_comments

Operaciones: list, create

Lee y añade comentarios en tareas y proyectos.

{"operation": "create", "taskId": "task_123", "content": "Updated the API endpoints as discussed"}

motion_schedules

Operaciones: list

Recupera los horarios de los usuarios, mostrando las horas de trabajo de cada día (inicio-fin por día) y las zonas horarias. Estos son solo plantillas recurrentes de horas de trabajo; no exponen eventos o reuniones reales del calendario, por lo que por sí solos no pueden mostrar una imagen real de disponibilidad; combínalos con scheduledStart/scheduledEnd de las tareas para ver lo que Motion ha reservado automáticamente.

motion_custom_fields

Operaciones: list, create, delete, add_to_project, remove_from_project, add_to_task, remove_from_task

Define y gestiona campos personalizados en espacios de trabajo, proyectos y tareas.

{
  "operation": "create",
  "name": "Sprint",
  "type": "DROPDOWN",
  "options": ["Sprint 1", "Sprint 2", "Sprint 3"],
  "workspaceName": "Development"
}

motion_recurring_tasks

Operaciones: list, create, delete

Gestiona plantillas de tareas recurrentes.

{
  "operation": "create",
  "name": "Weekly Team Standup",
  "recurrence": "WEEKLY",
  "projectName": "Team Meetings",
  "daysOfWeek": ["MONDAY", "WEDNESDAY", "FRIDAY"],
  "duration": 30
}

motion_statuses

Operaciones: list

Lista los estados disponibles para un espacio de trabajo.

Configuración avanzada

Configuración mínima (solo 3 herramientas):

{
  "mcpServers": {
    "motion": {
      "command": "npx",
      "args": ["motionmcp"],
      "env": {
        "MOTION_API_KEY": "your_api_key",
        "MOTION_MCP_TOOLS": "minimal"
      }
    }
  }
}

Selección de herramientas personalizadas:

{
  "mcpServers": {
    "motion": {
      "command": "npx",
      "args": ["motionmcp"],
      "env": {
        "MOTION_API_KEY": "your_api_key",
        "MOTION_MCP_TOOLS": "custom:motion_tasks,motion_projects,motion_search"
      }
    }
  }
}

Uso de tu espacio de trabajo local (npm):

{
  "mcpServers": {
    "motion": {
      "command": "npm",
      "args": ["run", "mcp:dev"],
      "cwd": "/absolute/path/to/your/MotionMCP",
      "env": {
        "MOTION_API_KEY": "your_api_key"
      }
    }
  }
}

Consulta la configuración completa para desarrolladores en DEVELOPER.md.

Depuración

• Los registros se emiten a stderr en formato JSON

• Comprueba si faltan claves, nombres de espacios de trabajo/proyectos y permisos

• Usa motion_workspaces (list) y motion_projects (list) para validar IDs

{
  "level": "info",
  "msg": "Task created successfully",
  "method": "createTask",
  "taskId": "task_789",
  "workspace": "Development"
}

Licencia

Apache-2.0 License

Para más información, consulta la documentación completa de la API de Motion o la documentación del Model Context Protocol.