# How to integrate Motion MCP with Codex

```json
{
  "title": "How to integrate Motion MCP with Codex",
  "toolkit": "Motion",
  "toolkit_slug": "motion",
  "framework": "Codex",
  "framework_slug": "codex",
  "url": "https://composio.dev/toolkits/motion/framework/codex",
  "markdown_url": "https://composio.dev/toolkits/motion/framework/codex.md",
  "updated_at": "2026-06-18T09:54:26.893Z"
}
```

## Introduction

Codex is one of the most popular coding harnesses out there. And MCP makes the experience even better. With Motion MCP integration, you can draft, triage, summarise emails, and much more, all without leaving the terminal or the app, whichever you prefer.

## Also integrate Motion with

- [Claude Cowork](https://composio.dev/toolkits/motion/framework/claude-cowork)

## TL;DR

### Why use Composio?
Apart from a managed and hosted MCP server, you will get:
- CodeAct: A dedicated workbench that allows GPT to write its code to handle complex tool chaining. Reduces to-and-fro with LLMs for frequent tool calling.
- Large tool responses: Handle them to minimise context rot.
- Dynamic just-in-time access to 20,000 tools across 1000+ other Apps for cross-app workflows. It loads the tools you need, so GPTs aren't overwhelmed by tools you don't need.

## Connect Motion to Codex

### How to install Motion MCP in Codex
### Run the setup command
Run this command in your terminal to add the Composio MCP server to Codex.

```bash
codex mcp add composio --url https://connect.composio.dev/mcp
```

## What is the Motion MCP server, and what's possible with it?

The Motion MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Motion account. It provides structured and secure access so your agent can perform Motion operations on your behalf.

## Supported Tools

| Tool slug | Name | Description |
|---|---|---|
| `MOTION_ADD_CUSTOM_FIELD_TO_PROJECT` | 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. |
| `MOTION_ADD_CUSTOM_FIELD_TO_TASK` | 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. |
| `MOTION_CREATE_COMMENT` | Create Comment | Tool to create a new comment on a Motion task. Use when you need to add a comment to an existing task. |
| `MOTION_CREATE_CUSTOM_FIELD` | 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. |
| `MOTION_CREATE_PROJECT` | 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. |
| `MOTION_CREATE_RECURRING_TASK` | 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. |
| `MOTION_CREATE_TASK` | 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. |
| `MOTION_DELETE_CUSTOM_FIELD` | 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. |
| `MOTION_DELETE_CUSTOM_FIELD_FROM_PROJECT` | 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. |
| `MOTION_DELETE_CUSTOM_FIELD_FROM_TASK` | 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. |
| `MOTION_DELETE_RECURRING_TASK` | 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. |
| `MOTION_DELETE_TASK` | 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. |
| `MOTION_GET_MY_USER` | Get My User Information | 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. |
| `MOTION_GET_PROJECT` | 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. |
| `MOTION_GET_TASK` | Get Task by ID | 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. |
| `MOTION_LIST_COMMENTS` | List comments on task | 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. |
| `MOTION_LIST_CUSTOM_FIELDS` | 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. |
| `MOTION_LIST_PROJECTS` | 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. |
| `MOTION_LIST_RECURRING_TASKS` | List Recurring Tasks | Tool to get all recurring tasks for a workspace. Use when you need to retrieve recurring task information from Motion. |
| `MOTION_LIST_SCHEDULES` | 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. |
| `MOTION_LIST_STATUSES` | 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. |
| `MOTION_LIST_TASKS` | 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. |
| `MOTION_LIST_USERS` | 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. |
| `MOTION_LIST_WORKSPACES` | 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. |
| `MOTION_MOVE_TASK` | Move Task to Workspace | Tool to move a task to a different workspace in Motion. Use when you need to relocate a task from one workspace to another. |
| `MOTION_UNASSIGN_TASK` | 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. |
| `MOTION_UPDATE_TASK` | 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. |

## Supported Triggers

None listed.

## Creating MCP Server - Stand-alone vs Composio SDK

The Motion MCP server provides comprehensive access to Motion operations through Composio. Once connected, you can perform all major Motion actions directly from Codex using natural language commands.

## Complete Code

None listed.

## Conclusion

### Conclusion
You've successfully integrated Motion with Codex using Composio's MCP server. Now you can interact with Motion directly from your terminal, VS Code, or the Codex App using natural language commands.
Key benefits of this setup:
- Seamless integration across CLI, VS Code, and standalone app
- Natural language commands for Motion operations
- Managed authentication through Composio
- Access to 20,000+ tools across 1000+ apps for cross-app workflows
- CodeAct workbench for complex tool chaining
Next steps:
- Try asking Codex to perform various Motion operations
- Explore cross-app workflows by connecting more toolkits
- Build automation scripts that leverage Codex's AI capabilities

## How to build Motion MCP Agent with another framework

- [Claude Cowork](https://composio.dev/toolkits/motion/framework/claude-cowork)

## Related Toolkits

- [Gmail](https://composio.dev/toolkits/gmail) - Gmail is Google's email service with powerful spam protection, search, and G Suite integration. It keeps your inbox organized and makes communication fast and reliable.
- [Google Calendar](https://composio.dev/toolkits/googlecalendar) - Google Calendar is a time management service for scheduling meetings, events, and reminders. It streamlines personal and team organization with integrated notifications and sharing options.
- [Outlook](https://composio.dev/toolkits/outlook) - Outlook is Microsoft's email and calendaring platform for unified communications and scheduling. It helps users stay organized with powerful email, contacts, and calendar management.
- [Google Sheets](https://composio.dev/toolkits/googlesheets) - Google Sheets is a cloud-based spreadsheet tool for real-time collaboration and data analysis. It lets teams work together from anywhere, updating information instantly.
- [Notion](https://composio.dev/toolkits/notion) - Notion is a collaborative workspace for notes, docs, wikis, and tasks. It streamlines team knowledge, project tracking, and workflow customization in one place.
- [Slack](https://composio.dev/toolkits/slack) - Slack is a channel-based messaging platform for teams and organizations. It helps people collaborate in real time, share files, and connect all their tools in one place.
- [Airtable](https://composio.dev/toolkits/airtable) - Airtable combines the flexibility of spreadsheets with the power of a database for easy project and data management. Teams use Airtable to organize, track, and collaborate with custom views and automations.
- [Gong](https://composio.dev/toolkits/gong) - Gong is a platform for video meetings, call recording, and team collaboration. It helps teams capture conversations, analyze calls, and turn insights into action.
- [Asana](https://composio.dev/toolkits/asana) - Asana is a collaborative work management platform for teams to organize and track projects. It streamlines teamwork, boosts productivity, and keeps everyone aligned on goals.
- [Google Tasks](https://composio.dev/toolkits/googletasks) - Google Tasks is a to-do list and task management tool integrated into Gmail and Google Calendar. It helps you organize, track, and complete tasks across your Google ecosystem.
- [Linear](https://composio.dev/toolkits/linear) - Linear is a modern issue tracking and project planning tool for fast-moving teams. It helps streamline workflows, organize projects, and boost productivity.
- [Microsoft teams](https://composio.dev/toolkits/microsoft_teams) - Microsoft Teams is a collaboration platform that combines chat, meetings, and file sharing within Microsoft 365. It keeps distributed teams connected and productive through seamless virtual communication.
- [Jira](https://composio.dev/toolkits/jira) - Jira is Atlassian’s platform for bug tracking, issue tracking, and agile project management. It helps teams organize work, prioritize tasks, and deliver projects efficiently.
- [Clickup](https://composio.dev/toolkits/clickup) - ClickUp is an all-in-one productivity platform for managing tasks, docs, goals, and team collaboration. It streamlines project workflows so teams can work smarter and stay organized in one place.
- [Slackbot](https://composio.dev/toolkits/slackbot) - Slackbot is a conversational automation tool for Slack that handles reminders, notifications, and automated responses. It boosts team productivity by streamlining onboarding, answering FAQs, and managing timely alerts—all right inside Slack.
- [Monday](https://composio.dev/toolkits/monday) - Monday.com is a customizable work management platform for project planning and collaboration. It helps teams organize tasks, automate workflows, and track progress in real time.
- [2chat](https://composio.dev/toolkits/_2chat) - 2chat is an API platform for WhatsApp and multichannel text messaging. It streamlines chat automation, group management, and real-time messaging for developers.
- [Addressfinder](https://composio.dev/toolkits/addressfinder) - Addressfinder is a data quality platform for verifying addresses, emails, and phone numbers. It helps you ensure accurate customer and contact data every time.
- [Agent mail](https://composio.dev/toolkits/agent_mail) - Agent mail provides AI agents with dedicated email inboxes for sending, receiving, and managing emails. It empowers agents to communicate autonomously with people, services, and other agents—no human intervention needed.
- [Agiled](https://composio.dev/toolkits/agiled) - Agiled is an all-in-one business management platform for CRM, projects, and finance. It helps you streamline workflows, consolidate client data, and manage business processes in one place.

## Frequently Asked Questions

### What are the differences in Tool Router MCP and Motion MCP?

With a standalone Motion MCP server, the agents and LLMs can only access a fixed set of Motion tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Motion and many other apps based on the task at hand, all through a single MCP endpoint.

### Can I use Tool Router MCP with Codex?

Yes, you can. Codex fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Motion tools.

### Can I manage the permissions and scopes for Motion while using Tool Router?

Yes, absolutely. You can configure which Motion scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

### How safe is my data with Composio Tool Router?

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Motion data and credentials are handled as safely as possible.

---
[See all toolkits](https://composio.dev/toolkits) · [Composio docs](https://docs.composio.dev/llms.txt)