# Motion

Motion is an intelligent calendar and project management tool that automatically plans your day, schedules meetings, and helps teams collaborate efficiently.

- **Category:** productivity
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 27
- **Triggers:** 0
- **Slug:** `MOTION`
- **Version:** 20260414_00

## Tools

### Add Custom Field to Project

**Slug:** `MOTION_ADD_CUSTOM_FIELD_TO_PROJECT`

Tool to add a custom field value to a project in Motion. Use when you need to set or update custom field data on an existing project.

### Add Custom Field to Task

**Slug:** `MOTION_ADD_CUSTOM_FIELD_TO_TASK`

Tool to add a custom field value to a task in Motion. Use when you need to set or update custom field data on an existing task.

### Create Comment

**Slug:** `MOTION_CREATE_COMMENT`

Tool to create a new comment on a Motion task. Use when you need to add a comment to an existing task.

### Create Custom Field

**Slug:** `MOTION_CREATE_CUSTOM_FIELD`

Tool to create a new custom field in a Motion workspace. Use when you need to add custom fields like text, select options, dates, or other field types to customize your workspace. For select/multiSelect types, provide options in metadata.

### Create Project

**Slug:** `MOTION_CREATE_PROJECT`

Tool to create a new project in Motion. Use when you need to create a project within a specific workspace. Projects can have optional due dates, descriptions (HTML supported), labels, and priority levels.

### Create Recurring Task

**Slug:** `MOTION_CREATE_RECURRING_TASK`

Tool to create a new recurring task in Motion. Use when you need to set up tasks that repeat on a schedule (daily, weekly, monthly, etc.). Recurring tasks automatically generate task instances based on the specified frequency pattern.

### Create Task

**Slug:** `MOTION_CREATE_TASK`

Tool to create a new task in Motion. Use when you need to add a task to a workspace with specified properties like name, priority, due date, and assignee.

### Delete Custom Field

**Slug:** `MOTION_DELETE_CUSTOM_FIELD`

Tool to delete a custom field from Motion workspace. Use when you need to remove a custom field that is no longer needed. This operation is permanent and cannot be undone.

### Delete Custom Field From Project

**Slug:** `MOTION_DELETE_CUSTOM_FIELD_FROM_PROJECT`

Tool to delete a custom field value from a project in Motion. Use when you need to remove a custom field value from a specific project.

### Delete Custom Field From Task

**Slug:** `MOTION_DELETE_CUSTOM_FIELD_FROM_TASK`

Tool to delete a custom field value from a task in Motion. Use when you need to remove a custom field value from a specific task by providing the task ID and custom field value ID.

### Delete Recurring Task

**Slug:** `MOTION_DELETE_RECURRING_TASK`

Tool to delete a recurring task from Motion based on the ID supplied. Use when you need to remove a recurring task permanently from the system.

### Delete Task

**Slug:** `MOTION_DELETE_TASK`

Tool to delete a task from Motion based on task ID. Use when you need to permanently remove a task from the Motion workspace.

### Get My User Information

**Slug:** `MOTION_GET_MY_USER`

Tool to get information on the owner of the API key. Use when you need to retrieve the current user's profile details including their ID, name, and email address.

### Get Project

**Slug:** `MOTION_GET_PROJECT`

Tool to retrieve a single project by its ID. Use when you need to get detailed information about a specific project including its name, description, status, and custom field values.

### Get Task by ID

**Slug:** `MOTION_GET_TASK`

Tool to retrieve a task by its ID from Motion. Returns complete task details including title, description, due date, priority, assignees, scheduling information, and custom fields.

### List comments on task

**Slug:** `MOTION_LIST_COMMENTS`

Tool to get all comments on a specific task. Use when you need to retrieve comment history for a task. Supports cursor-based pagination for tasks with many comments.

### List Custom Fields

**Slug:** `MOTION_LIST_CUSTOM_FIELDS`

Tool to retrieve all custom fields for a given Motion workspace. Use when you need to see what custom fields are available in a workspace.

### List Projects

**Slug:** `MOTION_LIST_PROJECTS`

Tool to get all projects for a workspace. Use when you need to retrieve all projects accessible to the API key, optionally filtered by workspace.

### List Recurring Tasks

**Slug:** `MOTION_LIST_RECURRING_TASKS`

Tool to get all recurring tasks for a workspace. Use when you need to retrieve recurring task information from Motion.

### List Schedules

**Slug:** `MOTION_LIST_SCHEDULES`

Tool to get a list of schedules for your user. Use when you need to retrieve the user's scheduling configuration including work hours and timezone settings.

### List Statuses

**Slug:** `MOTION_LIST_STATUSES`

Tool to get a list of statuses for a Motion workspace. Use when you need to retrieve available task statuses for a workspace.

### List Tasks

**Slug:** `MOTION_LIST_TASKS`

Tool to get all tasks for a given query with optional filtering. Use when you need to retrieve tasks from Motion, optionally filtered by assignee, project, workspace, status, label, or name.

### List users

**Slug:** `MOTION_LIST_USERS`

Tool to get a list of users for a given workspace or team. Use when you need to retrieve user information from Motion. Supports pagination via cursor and filtering by workspaceId or teamId.

### List Workspaces

**Slug:** `MOTION_LIST_WORKSPACES`

Tool to retrieve all workspaces a user has access to. Use when you need to discover available workspaces, filter for specific workspace IDs, or paginate through workspace results. Returns workspace details including type, team, labels, and statuses.

### Move Task to Workspace

**Slug:** `MOTION_MOVE_TASK`

Tool to move a task to a different workspace in Motion. Use when you need to relocate a task from one workspace to another.

### Unassign Task

**Slug:** `MOTION_UNASSIGN_TASK`

Tool to unassign a task from its current assignee. Use when you need to remove the assignee from a task, leaving the task unassigned.

### Update Task

**Slug:** `MOTION_UPDATE_TASK`

Tool to update an existing task in Motion. Use when you need to modify task properties like name, priority, due date, status, or assignee. Only provide the fields you want to update.
