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, damit Sie Aufgaben verwalten, Projekte durchsuchen, Ihren Zeitplan prüfen und vieles mehr können – alles über natürliche Unterhaltung. Er funktioniert auf Desktop, Web und Mobilgeräten.

Vorschau

Klicken Sie auf das Bild, um es in voller Größe zu sehen

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 Folgendes zu Ihrer claude_desktop_config.json hinzu:

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

Testen Sie es ü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 Mobile/Web, ChatGPT Mobile/Web und jeden anderen HTTP-MCP-Client.

Bereitstellung mit einem Klick

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

• MOTION_API_KEY – Ihr Motion-API-Schlüssel

• MOTION_MCP_SECRET – eine zufällige Zeichenfolge (erzeugen Sie eine 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 Secret steht am Ende des Pfads, und danach folgt nichts: Der Server kennt während einer Sitzung selbst seine Unterpfade (z. B. den Message-Endpunkt) aus. Hängen Sie also kein /sse oder einen anderen Unterpfad an das Secret.

Verbindung mit Claude herstellen

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

2. Fügen Sie Ihre MCP-URL hinzu

3. Der Server wird automatisch mit der Claude-Mobile-App synchronisiert

Verbindung mit ChatGPT herstellen

1. Gehen Sie zu ChatGPT Settings > Connectors

2. Fügen Sie Ihre MCP-URL hinzu

Sicherheit: Das Secret in der URL verhindert versehentliches Auffinden der URL. 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 die Variable per 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 (bei Ausführung 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 betreiben und die Tool-Auswahl eingrenzen 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, get, update, delete, move, unassign

Das wichtigste 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 über Namen referenzieren – 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_projects

Operationen: create, list, get

Verwalten Sie Motion-Projekte. Arbeitsbereichs- und Projektnamen werden unscharf abgeglichen, und der Server wählt automatisch Ihren Arbeitsbereich „Personal“ 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

Listen Sie Benutzer in einem Arbeitsbereich auf oder rufen Sie den aktuell authentifizierten Benutzer ab.

motion_search

Operationen: content

Durchsuchen Sie Aufgaben und Projekte per Suchanfrage in einem Arbeitsbereich.

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

motion_comments

Operationen: list, create

Kommentare zu Aufgaben und Projekten anzeigen und verfassen.

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

motion_schedules

Operationen: list

Benutzerzeitpläne und Zeitzonen abrufen. Unterstützt priorisierte Zeitplanung mit Konflikterkennung und Workload-Aufschlüsselung nach Status, Priorität und Projekt.

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 in Arbeitsbereichen, Projekten und Aufgaben.

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

Listen Sie verfügbare Status für einen Arbeitsbereich auf.

Erweiterte Konfiguration

Minimale Einrichtung (nur 3 Tools):

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

Individuelle 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 eines 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.

Debugging

• Logs werden im JSON-Format auf stderr ausgegeben

• Prüfen Sie auf fehlende Schlüssel, Arbeitsbereichs- und Projektnamen sowie 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.