Motion MCP Server

Motion ist eine KI-gestützte Kalender- und Aufgabenverwaltungs-App, die Ihre Arbeit automatisch plant. Dieser MCP-Server verbindet die Motion-API mit LLMs wie Claude und ChatGPT über das Model Context Protocol, sodass Sie Aufgaben verwalten, Projekte durchsuchen, Ihren Zeitplan überprüfen und vieles mehr können – alles durch natürliche Konversation. Er funktioniert auf Desktop, Web und Mobilgeräten.

Vorschau

Klicken Sie auf das Bild oben, um es in voller Größe anzuzeigen

Related MCP server: Motion MCP Server

Erste Schritte

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

Lokale Einrichtung (npx)

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

Fügen Sie zu Ihrer claude_desktop_config.json hinzu:

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

Testen Sie über die Befehlszeile:

MOTION_API_KEY=your_api_key npx motionmcp

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

Remote-Einrichtung (Cloudflare Workers)

Für mobile und Web-Clients – Claude mobil/Web, ChatGPT mobil/Web oder einen beliebigen HTTP-MCP-Client.

Ein-Klick-Bereitstellung

Nach der Bereitstellung legen Sie Ihre Geheimnisse im Cloudflare-Dashboard fest (Workers > Ihr Worker > Settings > Variables):

• MOTION_API_KEY – Ihr Motion-API-Schlüssel

• MOTION_MCP_SECRET – eine zufällige Zeichenfolge (generieren Sie mit openssl rand -hex 16)

Manuelle Bereitstellung

# 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 genau diese Adresse. Das Geheimnis steht am Ende des Pfads und nichts folgt darauf: Der Server bewirbt während einer Sitzung seine eigenen Unterpfade (z. B. den Nachrichten-Endpunkt). Hängen Sie daher weder /sse noch einen anderen Unterpfad an das Geheimnis an.

Verbindung von Claude herstellen

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

2. Fügen Sie Ihre MCP-URL hinzu

3. Der Server synchronisiert sich automatisch mit der Claude-Mobil-App

Verbindung von ChatGPT herstellen

1. Gehen Sie zu ChatGPT-Einstellungen > Connectors

2. Fügen Sie Ihre MCP-URL hinzu

Sicherheit: Das Geheimnis in der URL verhindert zufälliges Auffinden. Behandeln Sie die vollständige URL wie ein Passwort – teilen Sie sie nicht öffentlich.

Die Tool-Konfiguration funktioniert genauso wie beim lokalen Server. Setzen Sie MOTION_MCP_TOOLS in wrangler.toml unter [vars] oder überschreiben Sie es über wrangler secret put MOTION_MCP_TOOLS.

Für die lokale Worker-Entwicklung siehe DEVELOPER.md.

API-Schlüssel

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

Inline (npx):

MOTION_API_KEY=your-key npx motionmcp

.env-Datei (beim Ausführen aus dem Quellcode über npm):

MOTION_API_KEY=your-key

Wenn Sie npx verwenden, bevorzugen Sie die Inline-Umgebungsvariable, da npx keine lokale .env-Datei liest.

Tool-Konfiguration

Alle 10 Tools sind standardmäßig aktiviert. Wenn Sie mehrere MCP-Server ausführen und die Auswahl der Tools reduzieren möchten, können Sie über die Umgebungsvariable MOTION_MCP_TOOLS festlegen, welche Tools verfügbar sind:

Benutzerdefiniertes Beispiel:

MOTION_MCP_TOOLS=custom:motion_tasks,motion_projects,motion_search npx motionmcp

Tool-Referenz

motion_tasks

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

Das primäre Tool für die Aufgabenverwaltung. Unterstützt alle Motion-API-Parameter, einschließlich name, description, priority, dueDate, duration, labels, assigneeId und autoScheduled. Sie können Arbeitsbereiche und Projekte nach Namen referenzieren – der Server löst sie automatisch auf.

list_all_uncompleted umfasst alle Arbeitsbereiche in einem einzigen Aufruf (es ignoriert workspaceId/workspaceName) und berücksichtigt die Filter dueDate und priority, sodass „Was ist diese Woche in allen meinen Arbeitsbereichen fällig?“ direkt aufgelöst wird. Bei list ist dueDate eine inklusive Grenze für den Tag oder früher, die überfällige Aufgaben einschließt (so beantwortet dueDate: "today" die Frage „Was ist heute fällig?“), und completedAfter / completedBefore begrenzen nach Abschlussdatum in der Zeitzone Ihres Kontos für „Was habe ich diese Woche erledigt?“. Daten werden in der Zeitzone Ihres Motion-Kontos interpretiert, und Listenantworten beginnen mit einer Kopfzeile, die diese Zeitzone und das heutige lokale Datum angibt.

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

Operationen: create, list, get

Verwalten Sie Motion-Projekte. Arbeitsbereichs- und Projektnamen werden unscharf abgeglichen, und der Server wählt automatisch Ihren „Personal“-Arbeitsbereich aus, wenn keiner angegeben ist.

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

motion_workspaces

Operationen: list, get

Arbeitsbereiche auflisten und anzeigen.

motion_users

Operationen: list, current

Benutzer in einem Arbeitsbereich auflisten oder den aktuell authentifizierten Benutzer abrufen.

motion_search

Operationen: content

Durchsuchen Sie Aufgaben und Projekte per Abfrage in einem Arbeitsbereich.

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

motion_comments

Operationen: list, create

Kommentare zu Aufgaben und Projekten lesen und hinzufügen.

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

motion_schedules

Operationen: list

Rufen Sie Benutzerzeitpläne ab, die die Arbeitszeiten jedes Tages (Start-Ende pro Tag) und Zeitzonen anzeigen. Dies sind nur wiederkehrende Arbeitszeitvorlagen – sie legen keine tatsächlichen Kalenderereignisse oder Besprechungen offen und können daher allein kein echtes Frei/Belegt-Bild zeigen; kombinieren Sie sie mit scheduledStart/scheduledEnd der Aufgaben, um zu sehen, was Motion automatisch gebucht hat.

motion_custom_fields

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

Definieren und verwalten Sie benutzerdefinierte Felder über Arbeitsbereiche, Projekte und Aufgaben hinweg.

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

motion_recurring_tasks

Operationen: list, create, delete

Verwalten Sie Vorlagen für wiederkehrende Aufgaben.

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

motion_statuses

Operationen: list

Verfügbare Status für einen Arbeitsbereich auflisten.

Erweiterte Konfiguration

Minimale Einrichtung (nur 3 Tools):

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

Benutzerdefinierte Tool-Auswahl:

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

Verwendung Ihres lokalen Arbeitsbereichs (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-Einrichtung finden Sie in DEVELOPER.md.

Fehlerbehebung

• Logs werden im JSON-Format an stderr ausgegeben

• Prüfen Sie auf fehlende Schlüssel, Arbeitsbereichs-/Projektnamen und Berechtigungen

• Verwenden Sie motion_workspaces (list) und motion_projects (list), um IDs zu validieren

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

Lizenz

Apache-2.0-Lizenz

Weitere Informationen finden Sie in der vollständigen Motion-API-Dokumentation oder in der Model Context Protocol-Dokumentation.