# Motion MCP

> Motion MCP Server lets your AI client manage all scheduling, projects, and tasks using natural conversation. Create new tasks that automatically schedule themselves based on priority. List projects across multiple workspaces or update due dates in real-time—all without opening a calendar.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** ai-scheduling, task-automation, time-management, calendar-optimization, project-tracking, daily-planning

## Description

Motion lets your AI client manage every piece of scheduling and project work you got without making you open a single dashboard. You just talk to it—you tell Motion what needs to happen, and its engine handles the rest. Forget manually updating timelines or dragging tasks around; this thing uses natural conversation to make things move.

### Project Setup & Organization
When you're getting set up, your agent can first check out everything by using `list_workspaces`, which pulls a list of every separate container you've got access to in Motion. You can then see exactly what projects are active within any given space by calling `list_projects`; this shows you all the project containers available in your current workspace. If you need to group related tasks, use `create_project` to make a new, static container for those items right into your Motion workspace.

### Task Management & Modification
The core of what this thing does is managing individual tasks. You can generate a whole new task using `create_task`; the Motion AI engine immediately takes that task and schedules it onto your calendar automatically. If you need to change something about an existing item, call `update_task`—you can modify any configuration parameter, like changing its due date or bumping up its priority level.

Need to clear out some clutter? You use `delete_task` to permanently delete a specific task; that action automatically removes all associated time blocks from your calendar too. To know the specifics of one item without searching, you run `get_task`, which pulls all current details for a single task once you feed it its unique ID number.

### Workflow View & Movement
Your agent keeps tabs on everything moving around. You can list every task in a workspace using `list_tasks`; this function lets you narrow down the view by filtering tasks based on their current lifecycle status, like 'pending review.' If you need to see what else is going on, `get_task` helps pull all details for one specific item when you know its ID number. You can also get a full picture of projected completion times across an entire work area by calling `get_schedule`, which retrieves the AI-optimized timeline schedule for your workspace.

You'll find that tasks don't have to stay put either. If an item needs to move from one organizational context to another, use `move_task` to transfer a specific task from its current workspace into a totally different target workspace.

## Tools

### create_project
Creates a new, static container for grouping related tasks within your Motion workspace.

### create_task
Generates a new task that the Motion AI engine will automatically schedule and place on your calendar.

### delete_task
Permanently deletes a specified task, which also removes all associated blocks from your calendar.

### get_schedule
Retrieves the AI-optimized timeline schedule for a workspace, showing projected completion dates for tasks.

### get_task
Pulls all current details for one specific task when you know its ID number.

### list_projects
Shows a list of every project container available in your active Motion workspace.

### list_tasks
Lists all tasks in a workspace, allowing you to filter the results by their current lifecycle status.

### list_workspaces
Retrieves a list of every separate workspace container you have access to within Motion.

### move_task
Moves a specific task from one organizational workspace to an entirely different target workspace.

### update_task
Changes the configuration parameters of an existing task, such as its priority or due date.

## Prompt Examples

**Prompt:** 
```
List all my Motion workspaces
```

**Response:** 
```
I've retrieved 2 workspaces from your account: 'Engineering' (ID: ws-123) and 'Personal' (ID: ws-456). Which one would you like to list the projects or tasks for?
```

**Prompt:** 
```
Create a high-priority task 'Review PR #456' in workspace 'ws-123' due tomorrow, takes 30 mins
```

**Response:** 
```
Task 'Review PR #456' created successfully! Motion AI has automatically scheduled this for tomorrow at 10:30 AM based on your current workload. New Task ID: 'task-98765'. Would you like me to show your updated schedule?
```

**Prompt:** 
```
Show me the optimized schedule for my 'Engineering' workspace
```

**Response:** 
```
Retrieving AI-optimized schedule… I've identified your time blocks for today: 1) 09:00 - 'Email Triage', 2) 10:30 - 'Review PR #456', 3) 14:00 - 'Design Sync'. Motion has successfully resolved 5 tasks into your free slots. No priority conflicts detected.
```

## Capabilities

### Schedule New To-Dos
Creates a task and assigns it an automatic time slot based on its specified priority.

### View Workspace Projects
Lists all project containers in your active workspace, helping you group related tasks.

### Review Optimized Timelines
Retrieves the AI-calculated schedule for a given workspace to show projected task completion times.

### Update Task Details
Modifies an existing task's configuration, like changing its due date or priority level.

### Organize Tasks by Status
Lists all tasks within a workspace, narrowing the view using lifecycle filters (e.g., 'pending review').

## Use Cases

### The Daily Task Dump
A Project Manager wakes up with 15 random to-dos. Instead of opening 15 tabs and assigning time blocks, they tell their agent: 'Create a high-priority task for Q3 review in the Client A workspace.' The agent calls `create_task`, Motion schedules it immediately, and the PM sees the update on the day’s timeline.

### Scope Creep Containment
A team project needs to transition from a 'Phase 1' workspace to a new 'Maintenance' workspace. Instead of manually copying tasks, the Project Lead uses `move_task` on all relevant items. This cleanly updates the task’s container and keeps the history accurate.

### The Deadline Shift
A key deliverable date gets pushed back by a week. Instead of manually updating every related milestone, the Technical Lead uses `update_task` on that master item. The agent then recalculates all downstream dependencies and updates the whole schedule via `get_schedule`.

### Auditing Project Components
The PM needs to know what's currently active in the 'Alpha Launch' container. They use `list_projects` first, then focus on a specific project ID and run `list_tasks`, filtering by 'In Progress.' This provides an instant status report without manual data gathering.

## Benefits

- Automatically schedules time blocks. Instead of manually allocating time, use `create_task` with a priority (HIGH/LOW), and Motion handles the calendar math for you.
- See the big picture instantly. Run `get_schedule` to get an AI-optimized view that shows *all* tasks resolved into your free slots, revealing potential conflicts before they happen.
- Keep things organized across teams. Use `list_workspaces` and then `create_project` to group related work in isolated containers, keeping project scopes clean.
- Don't lose track of where stuff goes. If a task needs to move from 'Marketing' to 'Product', just use `move_task`. It keeps the data model current without manual effort.
- Quickly check status. Use `list_tasks` and apply filters (like 'pending review') to narrow down your focus, instead of scrolling through hundreds of entries.
- Keep it accurate. After a task is done, run `delete_task`. This cleans up the log, preventing old, obsolete items from cluttering your project history.

## How It Works

The bottom line is you talk to your agent, and it runs the necessary Motion commands to update your project timeline automatically.

1. Subscribe to this server and input your Motion API Key.
2. Instruct your agent via natural language: e.g., 'Create a high-priority task for X in the Engineering workspace.'
3. Your AI client calls the relevant tool (like `create_task` or `update_task`), and the schedule updates instantly.

## Frequently Asked Questions

**How do I see all my separate work areas in Motion using list_workspaces?**
You call `list_workspaces`. This tool retrieves a complete list of every workspace container you have access to. It helps you know exactly which context your agent needs to run commands against.

**Can I change a task's due date using the update_task tool?**
Yes, `update_task` changes parameters like priority or the due date. Critically, after you use this tool, Motion signals the AI engine to immediately recalculate your entire schedule.

**What is the difference between list_projects and list_tasks?**
`list_projects` shows you the high-level containers (the grouping), while `list_tasks` shows the individual items within a specific container. You usually run them in sequence to map out scope.

**If I delete a task, does it remove its scheduled time from my calendar? (delete_task)**
Yes, `delete_task` permanently deletes the task and removes all associated blocks from your calendar. Use this when you know for sure that the work is obsolete.

**When I use the optional status filters with the `list_tasks` tool, what types of statuses can I narrow my results by?**
The `list_tasks` tool lets you filter tasks based on their current lifecycle state. You can specify statuses like 'Completed', 'In Progress', or 'Blocked' to pull a focused list. This is useful for auditing specific task batches, rather than listing everything in the workspace.

**If I use `create_task` with tight deadlines, how does the system resolve scheduling conflicts using the AI engine?**
The Motion AI engine automatically resolves time overlaps and dependencies. When you run `get_schedule`, it shows the optimized timeline that accommodates your new task by adjusting surrounding blocks. You don't need to manually check for conflicts.

**What exactly does the `move_task` tool do when I change a task's workspace container?**
The `move_task` tool changes the organizational context of the task. It doesn't change the content or due date; it just reassigns the task to a different project boundary, helping you group tasks under a new initiative.

**What is the practical difference between listing projects using `list_projects` versus simply grouping tasks?**
Projects are containers. When you use `create_project`, you define a high-level scope for related work. Listing them shows these defined groups, which gives structure to the individual tasks within them.

**How does Motion's AI auto-scheduling work through the agent?**
When you use the `create_task` tool, you specify a priority (ASAP to LOW). Your agent dispatches this to Motion, which immediately finds the best available blocks in your calendar, ensuring your high-priority items are scheduled first without manual intervention.

**Can I move tasks between different workspaces through a conversation?**
Yes. Use the `move_task` tool by providing the Task ID and the Destination Workspace ID. Your agent will update the task's logic container, allowing you to organize your schedule across personal and professional boundaries seamlessly.

**How do I see my projected completion times for all tasks in a workspace?**
The `get_schedule` tool retrieves the AI-optimized timeline for a specific Workspace ID. Your agent will report the projected time blocks for each task, showing you exactly how Motion's AI has resolved your daily priorities.