Motion

Motion MCP Server lets you connect AI assistants to Motion for task and project management, enabling natural language interactions to list, create, update, and organize tasks, projects, workspaces, and related data securely through an MCP client.

How to use

You interact with the Motion MCP Server through your MCP client by telling it what you want to do with Motion. Start simple: ask it to list tasks, create a task with a due date and priority, move a task to a different workspace, add comments, or set up recurring tasks. The server translates your natural language requests into Motion API calls and returns structured results that your assistant can present to you.

How to install

Prerequisites: you need Node.js and npm installed on your machine.

Install the Motion MCP Server globally using npm.

npm install -g @h3ro-dev/motion-mcp-server

Configuration

Configure your MCP client to run the Motion MCP Server locally. Use the provided stdio configuration snippet and replace your-api-key with your actual Motion API key.

{
  "mcpServers": {
    "motion": {
      "command": "npx",
      "args": ["-y", "@h3ro-dev/motion-mcp-server"],
      "env": {
        "MOTION_API_KEY": "your-api-key"
      }
    }
  }
}

Security and runtime notes

Keep your Motion API key secure. Store configuration in a directory with proper permissions and avoid committing keys to version control. The server will pass requests to Motion using the provided API key and respects Motion’s rate limits.

Troubleshooting

If you encounter an invalid API key, verify you pasted it correctly, remove stray spaces, and regenerate if needed. If you hit rate limit errors, the server automatically handles retries within the configured window; ensure your database path is writable.

Available tools

motion_list_tasks

List tasks with filters such as workspace, status, and assignee to retrieve task collections from Motion.

motion_get_task

Retrieve detailed information for a specific task by its ID.

motion_create_task

Create a new task with properties like name, workspaceId, dueDate, and priority.

motion_update_task

Update attributes of an existing task, including status and priority.

motion_delete_task

Delete a task by its ID.

motion_move_task

Move a task to a different workspace by taskId and workspaceId.

motion_unassign_task

Remove the assignee from a task by taskId.

motion_list_projects

List projects within a workspace, optionally filtered by workspaceId.

motion_get_project

Retrieve details for a specific project by projectId.

motion_create_project

Create a new project with a name and workspaceId.

motion_update_project

Update project metadata such as name or other attributes.

motion_archive_project

Archive a project by projectId.

motion_list_workspaces

List all workspaces available to the Motion account.

motion_get_workspace

Get details for a specific workspace.

motion_list_users

List users within a workspace.

motion_get_current_user

Get information about the current user.

motion_list_comments

List comments for a specific task.

motion_create_comment

Add a comment to a specific task.

motion_list_recurring_tasks

List recurring tasks in Motion.

motion_create_recurring_task

Create a new recurring task.

motion_delete_recurring_task

Delete a recurring task by its ID.

motion_list_schedules

List schedules configured in Motion.