productivityapi_key

Motion

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

Verdict

Motion's MCP brings AI-powered project and task management into your Switchy workspace. @mention Motion to create tasks, set up recurring workflows, manage projects, and update custom fields without leaving the conversation. Teams using Motion for auto-scheduling get the most value — you can triage incoming work, adjust priorities, and check status all from chat. The MCP requires an API key with workspace-level permissions, so setup needs admin access. Motion's custom field system is powerful but verbose; expect longer prompts when working with select or multi-select fields.

Common use cases

  • Triage incoming requests into Motion tasks
  • Set up recurring standup or review tasks
  • Update project custom fields from chat
  • Check task status during team sync
  • Create projects with labels and priorities

Integration

Vendor
Motion
Category
productivity
Auth
API_KEY
Tools
27
Composio slug
motion

Tools

  • 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

    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

    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

    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

    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

    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

    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
    destructive

    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
    destructive

    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
    destructive

    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
    destructive

    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
    destructive

    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

    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

    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

    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

    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

    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

    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

    Tool to get all recurring tasks for a workspace. Use when you need to retrieve recurring task information from 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

    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

    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

    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

    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

  • 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.

  • 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

    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.

Setup

Setup guide

  1. 11. In Switchy, open your workspace settings and navigate to the Integrations tab. 2. Click 'Add MCP Integration' and select Motion from the list. 3. In Motion, go to Settings > API & Integrations and generate a new API key with read/write permissions for tasks, projects, and custom fields. 4. Copy the API key and paste it into Switchy's Motion configuration dialog, then click Connect. 5. Switchy will verify the key and list your Motion workspaces — select the workspace you want to access. 6. To test the connection, open any Space and type '@Motion list my tasks' — you should see a response with your current Motion tasks. 7. From now on, @mention Motion in any Space to create tasks, update projects, or query your workspace data.

What teammates see: by default, memories from Motion are scoped to the Space (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.

Works well with

Top models

Compatibility data appears once enough Spaces have used this MCP together with a given model.

How Switchy teams use it

Not enough Spaces yet to publish anonymised usage stats (we require ≥ 50 Spaces per week).

Starter prompts

Create Weekly Review Task

@Motion create a recurring task called 'Weekly Team Review' that repeats every Friday at 2pm, assigned to me, with high priority and a 1-hour duration.
Open in a Space →

Triage Support Request

@Motion create a task called 'Investigate login issue for customer #4521' in the Support workspace, assign it to Sarah, set priority to urgent, and make it due tomorrow.
Open in a Space →

Update Project Status Field

@Motion add a custom field to project 'Q1 Website Redesign' with field name 'Status' and value 'In Review'.
Open in a Space →

Create Sprint Project

@Motion create a project called 'Sprint 12: Mobile Onboarding' in the Engineering workspace, due March 15th, with label 'frontend' and description 'Redesign mobile signup flow with social auth options'.
Open in a Space →

Add Task Comment

@Motion add a comment to task 'Fix checkout bug' that says 'Tested on staging, issue persists with Stripe webhooks — escalating to payments team'.
Open in a Space →

Example outputs

Illustrative - representative of the model's voice and quality, not literal recordings.

Prompt

@Motion show me all high-priority tasks assigned to me that are due this week, grouped by project

Output

Based on your Motion workspace, you have 7 high-priority tasks due this week across 3 projects: **Q1 Product Launch** (4 tasks) - Finalize landing page copy (due Wed) - Review design mockups (due Thu) - Schedule launch meeting (due Fri) - Prepare press kit (due Fri) **Client Onboarding - Acme Corp** (2 tasks) - Complete security questionnaire (due Tue) - Set up staging environment (due Thu) **Team Operations** (1 task) - Submit quarterly budget forecast (due Wed) All tasks are currently scheduled in your Motion calendar with auto-scheduled time blocks.

Notes

This example showcases Motion's task filtering and organization capabilities. Requires read access to tasks and projects via API key. Motion's auto-scheduling feature means task timing may shift as priorities change throughout the week—the response reflects a point-in-time snapshot of your schedule.

Prompt

@Motion create a recurring weekly task called 'Team standup prep' every Monday at 9am, assign it to me with medium priority

Output

Created recurring task successfully: **Team standup prep** - Recurrence: Weekly on Mondays at 9:00 AM - Priority: Medium - Assigned to: You - Workspace: Default - Status: Active Motion will automatically generate task instances each week and schedule them in your calendar. The first instance is scheduled for Monday, January 13 at 9:00 AM. You can modify individual instances or update the recurrence pattern anytime from the Motion app.

Notes

Demonstrates Motion's recurring task creation, which is central to workflow automation. The MCP creates the recurrence rule but doesn't control how Motion's auto-scheduler places each instance—timing may adjust based on your calendar conflicts and other priorities. Requires write access to tasks.

Prompt

@Motion review all tasks in the 'Website Redesign' project and draft a status update summarizing progress, blockers, and what's due next

Output

Analyzed 12 tasks in the **Website Redesign** project: **Progress Summary:** 8 tasks completed (67%), including all design mockups and initial development setup. The project is on track for the Feb 15 deadline. **Current Blockers:** - 'Integrate payment gateway' (due Jan 18) is waiting on API credentials from finance team - 'Accessibility audit' (due Jan 22) needs external vendor selection—no vendor assigned yet **Coming Up Next Week:** - Complete mobile responsive layouts (due Jan 16) - Finalize CMS migration plan (due Jan 17) - Begin QA testing phase (due Jan 19) Recommendation: Escalate the API credentials request to unblock payment integration work.

Notes

This synthesis example shows how the AI can read Motion's project and task data, then apply reasoning to generate insights. The MCP provides raw task details (status, due dates, assignees); the AI interprets patterns and blockers. Most valuable when projects have 10+ tasks where manual review becomes tedious.

Use-case deep-dives

Client project intake at agencies

When Motion's custom fields beat generic task tools for client work

A 6-person agency runs 12 active client projects at once. Each project needs client-specific metadata: budget tier, contract end date, primary contact, approval stage. Motion's custom field tools let you template this structure once, then populate it per project without spreadsheet drift. The Create Custom Field and Add Custom Field to Project tools mean intake forms flow directly into Motion's auto-scheduler. This works if your project count stays under 30 and you're not integrating a separate CRM—Motion becomes the single source for project metadata. If you're already running HubSpot or Salesforce for client data, the API_KEY auth makes syncing possible but adds maintenance overhead. Buy Motion here if your agency's project complexity lives in task dependencies and deadlines, not in heavyweight CRM workflows.

Weekly sprint planning for product teams

Motion's recurring task setup saves 20 minutes per sprint kickoff

A 4-person product team runs two-week sprints with the same ceremony tasks every cycle: draft release notes, schedule demo, update roadmap doc, send stakeholder email. Motion's Create Recurring Task tool templates these once with assignees and due-date offsets, then auto-generates instances at sprint start. The time win is real if your sprint structure is stable—you skip the manual task-creation ritual in standup. The trade-off: Motion's 27 tools don't include native integrations for Linear or Jira, so you're either migrating task tracking entirely to Motion or maintaining two systems. This scenario wins when your team is small enough that Motion's auto-scheduler replaces your project manager, not when you need deep issue-tracking features. If your sprint involves more than 40 tasks or complex sub-task hierarchies, Motion's flat task model starts to feel limiting.

Support team ticket follow-up tracking

Motion's comment threading works for internal follow-up, not customer-facing support

A 3-person support team uses Zendesk for customer tickets but needs internal task tracking for follow-ups that span multiple days: bug escalations, feature requests passed to product, refund approvals. Motion's Create Task and Create Comment tools let you spin up a task per escalation and thread updates without cluttering the customer-facing ticket. The API_KEY auth means you can script task creation from Zendesk webhooks if you have a developer hour to spare. This setup works when follow-ups are the exception, not the rule—if more than 30% of tickets need internal tracking, you're better off with a support tool that has built-in SLA and escalation logic. Motion doesn't replace your helpdesk; it handles the 'we'll get back to you in 3 days' tasks that fall through the cracks. Buy this if your support volume is under 200 tickets/month and your team already trusts Motion's calendar for deadline management.

Frequently asked

What does the Motion MCP let me do in Switchy?

It connects your Motion workspace so AI agents can create tasks, projects, and recurring schedules, add comments, and manage custom fields—all without leaving the chat. You can ask an agent to build a project plan, assign tasks to teammates, or update custom field values, and it executes directly in Motion using the 27 available tools.

Do I need admin access to connect Motion?

You need an API key from Motion, which typically requires workspace admin or owner permissions to generate. Once you paste the key into Switchy, the MCP inherits whatever access that key has—so if the key can create projects and assign tasks, the agent can too. Check Motion's API settings to confirm your role can issue keys.

Can the Motion MCP read my calendar or auto-schedule tasks?

No. The MCP focuses on task and project CRUD operations—creating tasks, adding comments, managing custom fields—but it doesn't interact with Motion's calendar or auto-scheduling engine. If you need an agent to reason about free time slots, you'd connect a separate calendar MCP (Google Calendar, Outlook) and coordinate manually.

Why use this instead of just opening Motion?

The MCP shines when you want an agent to batch-create tasks from a document, sync project status across tools, or update dozens of custom fields at once. For ad-hoc task entry or drag-and-drop scheduling, Motion's UI is faster. Think of the MCP as the automation layer—best for repetitive workflows your team runs weekly.

Who on my team should connect the Motion integration?

Whoever owns your Motion workspace and can generate API keys. That person's key determines what the agent can touch—workspaces, projects, assignees. If multiple people need agent access, they can each connect their own key in Switchy, or you can share one key and accept that all agent actions appear under a single Motion user.

Data last verified 607 hours ago.Sources aggregated hourly to weekly. See docs/architecture/model-directory.md.