productivity
Motion MCP, CLI, and Lua Integration for AI Agents
Motion integration docs for AI agents: MCP gateway setup, Motion CLI commands, Lua API reference, credentials, and function schemas.
7 functions 6 read 1 write Bearer token auth
Motion for agents
Credentials can be configured manually in web or CLI hosts.
Use this integration from Lua code mode, the headless integrations CLI, or the KosmoKrator MCP gateway. The same package metadata powers all three surfaces.
Machine-Readable Metadata
- integration_slug
motion- route_slug
motion- package
motion- auth_strategy
bearer_tokenBearer token- cli_setup_supported
true- cli_runtime_supported
true- mcp_gateway_supported
true- lua_supported
true- supports_multi_account
true
Quick Links
Lua APIAgent-facing namespace and function reference. Motion CLIHeadless setup and direct function calls. Motion MCPMCP gateway setup for external clients. Submit feedbackReport missing tools, auth problems, wrong docs, or runtime issues. ContributeAdd tools or improve metadata in the integrations repo.
Motion MCP Client Matrix
Use these pages when a specific agent client or framework needs copy-pasteable MCP setup for Motion.
Claude Code Motion MCP setup for Claude Code. Cursor Motion MCP setup for Cursor. Codex Motion MCP setup for Codex. OpenAI Agents Motion MCP setup for OpenAI Agents SDK. Claude Agent SDK Motion MCP setup for Claude Agent SDK. Vercel AI SDK Motion MCP setup for Vercel AI SDK. LangChain Motion MCP setup for LangChain. LangGraph Motion MCP setup for LangGraph. CrewAI Motion MCP setup for CrewAI. MCP clients Motion MCP setup for Generic MCP Clients.
Motion CLI Matrix
Use these pages for direct Motion CLI workflows in scripts, CI, cron, and agent wrappers.
CI Motion CLI for CI. Cron Jobs Motion CLI for cron jobs. Shell Scripts Motion CLI for shell scripts. Headless Automation Motion CLI for headless automation. Coding Agents Motion CLI for coding agents.
Function Catalog
| Function | Type | Parameters | Description |
|---|---|---|---|
motion.motion_list_tasks | Read read | 5 | List tasks from Motion with optional filters. Filter by status, project, or assignee. Supports cursor-based pagination. |
motion.motion_get_task | Read read | 1 | Get details of a specific task in Motion by its ID. Returns the task name, description, status, assignee, due date, priority, and project. |
motion.motion_create_task | Write write | 6 | Create a new task in Motion. Requires a task name. Optionally specify a project, assignee, due date, priority, and description. Motion will auto-schedule the task based on priorities and deadlines. |
motion.motion_list_projects | Read read | 0 | List all projects in Motion. Returns project IDs, names, and other metadata. Use project IDs to filter tasks or create tasks in specific projects. |
motion.motion_get_project | Read read | 1 | Get details of a specific project in Motion by its ID. Returns the project name, description, status, and other metadata. |
motion.motion_list_schedules | Read read | 2 | List schedules from Motion within a date range. Returns scheduled tasks and events for the authenticated user. |
motion.motion_get_current_user | Read read | 0 | Get the profile of the currently authenticated Motion user. Returns user ID, name, email, and other account details. |