Motion MCP Server

Connects Claude.ai to your Motion workspace via the Motion REST API.

Tools included

Tool	Description
list_workspaces	List all workspaces
list_tasks	List tasks (filter by workspace, project, assignee, status, label)
get_task	Get a single task by ID
create_task	Create a new task
update_task	Update an existing task
delete_task	Delete a task
move_task	Move task to another workspace/project
list_projects	List projects in a workspace
get_project	Get a project by ID
create_project	Create a new project
list_users	List workspace members
get_my_user	Get current user profile
get_statuses	Get task statuses for a workspace
get_schedules	Get schedules
get_comments	Get comments on a task
create_comment	Add a comment to a task
list_recurring_tasks	List recurring tasks

---

Local setup

# 1. Install dependencies
npm install

# 2. Set your Motion API key
export MOTION_API_KEY=your_api_key_here

# 3. Start the server
npm start

Test it:

curl http://localhost:3000/
# → {"status":"ok","name":"motion-mcp","version":"1.0.0"}

---

Deploy to Railway (free tier)

1. Push this folder to a GitHub repo
2. Go to railway.app → New Project → Deploy from GitHub Repo
3. Select your repo
4. In Railway dashboard → Variables → Add:

   MOTION_API_KEY = your_api_key_here
   

5. Railway will give you a public URL like https://motion-mcp-production.up.railway.app

---

Deploy to Render (free tier)

1. Push this folder to a GitHub repo
2. Go to render.com → New → Web Service
3. Connect your repo
4. Set:
   • Build command: npm install
   • Start command: npm start
   • Environment variable: MOTION_API_KEY = your_api_key_here
5. Render will give you a public URL like https://motion-mcp.onrender.com

---

Add to Claude.ai

Once hosted:

1. Go to claude.ai/customize/connectors
2. Click + → Add custom connector
3. Enter your public URL + /mcp
   e.g. https://motion-mcp-production.up.railway.app/mcp
4. Click Add
5. Enable it per conversation via the + button → Connectors

---

Environment variables

Variable	Required	Description
MOTION_API_KEY	✅ Yes	Your Motion API key (from Motion Settings)
PORT	No	Port to run on (default: 3000)