Motion MCP Server

Motion es una aplicación de calendario y gestión de tareas impulsada por IA que agenda tu trabajo automáticamente. Este servidor MCP conecta la API de Motion con modelos de lenguaje (LLM) como Claude y ChatGPT a través del Model Context Protocol, para que puedas gestionar tareas, buscar proyectos, consultar tu agenda y mucho 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

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 requiere instalación.

Configuración remota (Cloudflare Workers)

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

Implementación con un clic

Después de implementarlo, configura tus secretos en el panel de Cloudflare (Workers > tu worker > Configuración > Variables):

• MOTION_API_KEY — tu clave de API de Motion

• MOTION_MCP_SECRET — una cadena aleatoria (genera una con openssl rand -hex 16)

Implementación 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 de 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 debe ir después: 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 > Configuración > Conectores

2. Añade tu URL de MCP

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

Conexa desde ChatGPT

1. Ve a Configuración de ChatGPT > Connectors

2. Añade tu URL de MCP

Seguridad: El secreto dentro de la URL evita que se descubra accidentalmente. Trata la URL completa como una contraseña: no la compartas públicamente.

La configuratión de herramientas funciona igual que en el servidor local. Establece MOTION_MCP_TOOLS en wrangler.toml bajo [vars], o anúlalo mediante wrangler secret put MOTION_MCP_TOOLS.

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

Clave de API

El serverador lee tu clave de API de Motion de 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 con npm):

MOTION_API_KEY=your-key

Cuando uses npx, prefiere la variable de entorno en línea, porque npx no lee un archivo .env local.

Tool Configure

Configuración de herramientas

Las 10 herramientas están habilitadas por defecto. Si ejecutas varios servidores MCP o quieres reducir el ruido en la selección de herramientas, puedes limitar las herramientas expuestas 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

matriz de proyectos

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

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

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

matriz de proyectos

Operaciones: create, list, get

Gestiona proyectos de Motion. Los nombres de espacios de trabajo y proyectos se emparejan de forma flexible, y el servidor selecciona automáticamente tu espacio «Personal» si no se usa ninguno.

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

webdekspaces

Operaciones: list, get

Lista e inspecciona espacios de trabajo.

usuarios_motivos

Operaciones: list, current

Lista los usuarios de un espacio de trabajo o obtén el usuario autenticado actual.

búsqueda_motivos

Operaciones: content

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

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

comentarios_motivos

Operaciones: list, create

Lee y añade comentarios en tareas y proyectos.

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

calendarios_motivos

Operaciones: list

Obtiene los horarios y las zonas horarias de los usuarios. Soporta una planificación priorizada condetect de conflictos y desglose de tareas por estado, prioridad y proyecto.

campos_personalizados_motivos

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"
}

previas_planteadas

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
}

estados_motivos

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

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

Usar 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"
      }
    }
  }
}

Puedes ver la configuración completa en DEVELOPER.md.

Depuración

• Los registros se emiten a stderr en formato JSON

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

• Usa motion_workspaces (list) y motion_projects (list) para validar los 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 de la API de Motion o del Model Context Protocol.