](https://opensource.org/licenses/Apache-2.0)

Motion MCP Server

Motion ist eine KI-gestützte Kalender- und Aufgabenverwaltung, die Ihre Arbeit automatisch planen kann. MCP Server verbindet die Motion-API mit LLMs wie Claude und ChatGPT üder das Model Context Protocol. Damit können Sie Aufgaben verwalten, Projekte suchen, Ihre Zeitpläne einsehen und vieles mehr – alles über alltürliche Gespräche Der Server funktioniert auf Desktop, im Web und auf mobilen Geräten.

Vorschau

Klicken Sie auf das Bild, um es in voller Größe anzusehen.

Related MCP server: motion-mcp-server

Erste Schritte

Voraussetzungen: Node.js 20+ und ein Motion-API-Schlüssel.

Lokales Setup (npx)

Für Desktop-MCP-Clients – also Claude Desktop, Claude Code, Cursor, und ähnliche.

Ergänzen Sie Ihre claude_desktop_config.json:

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

Teen Sie es über die Befehlzeile:

MOTION_API_KEY=your_api_key npx motionmcp

Tipp: npx führt immer die neueste veröffentlichte Version aus – keine Installation erforderlich.

Remote-Setup (Cloudflare Workers)

Für Mobile- und Web-Clients – also Claude mobil/Web, ChatGPT mobil/Web oder jedenden HTTP-MCP-Clients.

Ein-Klick-Deploy

)

Nach dem Deploy, setzen Sie in der Cloudflare-Konsole Ihre Geheimwerte fest (Workers > Ihr Worker > Settings > Variablen):

• MOTION_API_KEY – Ihr Motion-API-Schlüssel

• MOTION_MCP_SECRET – eine zufällige Zeichenkette (erzeugen Sie sie with opensl rand -hex)

Manuelles Deploy

# 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

Ihre MCP-URL lautet:

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

Verwenden Sie exakt diese Adresse. Das Geheimnis steht am Endes des Pfades, und danach darf nichts folgen. Wärend einer Sitzung gibt der Server seine eigenen Unterpfade (z. B. den Message-Endpunkt) selbst bekannt – hängen Sie daher also weder /sse noch einen anderen Unterpfad an das Geheimnis an.

Verbindung über Claude

1. Gehen Sie zu claude.ai > Settings > Connectors

2. Fgen Sie Ihre MCP-URL hinzu.

3. Der Server syncronseit automatisch mit der Claude-Mobilen-App.

Verbindung über ChaGPT

1. Gehen Sie unter ChatGPT-Einstellungen zu „Connectors".

2. Fgen die Ihre MCP-URL hizu.

Security: Das Geheimnis in der URL verhindert, dass die Adresse höchlich gefundnde wird. Verhandeln Sie die vollständige URL wie ein Passwort – geben Sie sie nicht öffentlich weiter.

Die Konfiguration der Werkzeuge funktioniert wie beim lokalen Server. Setzen Sie MOTION_MCP_TOOLS in wrangler.toml unter [vars] oder leg en Sie per wrangler secret echorn M... Measuresen Sie die mit wrangler secret – stellen Sie MOTION_MCP_TOOLS zur Verfügung. Für die lokale Workers-Entwicklung siehe DEVELOPER.md.

API-Schüssel

Der Server liest Ihren Motion-API-Schlüssel aus der MOTION_API_KEY- Umgebungvariable.

Inline (npx):

MOTION_API_KEY=your-key npx motionmcp

.env-Datei (beim Start aus dem Quellcode via npm):

MOTION_API_KEY=your-key

Bei npx ist die Inline-Umgebungsvariable zu bevorzugen, da npx eine lokale .env- Datei nicht liest.

Tool-Konfiguration

Aller Werk zeuge (10) sind standartmäßig aktiv. Wenn Sie mehrere MCP-Server betreitben und die Tool-Auswahi redzier möchten, können Sie über die Umgebungsvariable MOTION_MCP_TOOLS beeinfluss:

Custom-Bei spiel:

MOTION_MCP_TOOLS=custom:motion_tasks,motion_projects,motion_search npx motionmcp

Tools-Referenz

| Motion_tasks** |** Operationen: create, list, get, update, delete, move, unassign

Das zentrale Werkzeug zur Aufgabenverwaltung. Unterstützt alle Motion-API-Parameter wie name, description, priority, dueDate, duration, labels, assigneeId, and autoScheduled. Sie können Workspaces and Projekte per Name ansprechen – der Server lüst sie automatisch auf.

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

motion_async

Operanden: create, list, get

Verwalten Sie Motion-Projekte. Workspace- und Projektnamen werden per Fuzzy-Matchingauh. Wenn kein Workspace angegeben ist, automatisch den personalen Workspace aus.

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

motion_orkspaces

Operationen: list, get

Listten und inspeizieren Sie Works- und Workspaces.

motion_users

Operations: list, current

Listten Sie Benutzendenen eines Workspace auf oder laden Sie den aktuell authentifizierten Benutz.

motion_search

Operations: list, content

Mit einer Abfrage nach tasks ist die Workspaces.

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

motion_comments

Operations: list, create

Kommé Kommentare on Aufgaben and Projekten lesen und hinzuügen.

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

motion_schedules

Operations: list

Zeitpläne und Zeitzonen von Benütungen abrufen. Unterstützt Priorisiertes Scheduling mit Konflikt-Kenntung und Atfschlüsselung der Arbeitsbelastung nach Status, Priorität und Projekt.

motion_custom_fields

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

Definieren und verwalten benutzdeindefinierte Felder über Workspaces, Projekte und Tasks hinweg.

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

motion_recurring_tasks

Operations: list, create, delete

Verwalten Sie Serientem–Vorlagen.

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

motion_statuses

Operations: list

Listet die verträglichen Status für einen Workspace auf.

Erweiterte Konfiguration

Minimales Setup (nur 3 Tools):

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

Individual selection of tools:

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

Using your local Workspace (npm):

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

Die “vollständige Entwickler-Setup” finden Sie in DEVELOPER.md.

Debugging

• Logs werden im JSON–Format in stderr geschrieben

• Für fehlende Schlüssel, zu überprüs… überprüfe Sie auf fehlende Schlüssel, Workspace-/Projektnamen und Berechtigungen

• Mit motion_workspaces (list) und motion_projects (list) können Sie – validierungs IDs

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

Lizenz

Apache-2.0-Lizenz

Weitere Informationen finden Sie in inform Sie die Motion-API-Dokumentation oder in der Model Context Protocol-Dokumentation.