# 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

```bash
# 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:
```bash
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](https://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](https://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) |