Motion

Manage tasks and projects in Motion using AI assistants.

Motion MCP Server

Connect AI assistants to Motion for task and project management.

Installation

npm install -g @h3ro-dev/motion-mcp-server

Quick Setup

1. Get Motion API Key

Motion → Settings → API & Integrations → Create New API Key

2. Configure

Claude Desktop

{
  "mcpServers": {
    "motion": {
      "command": "npx",
      "args": ["-y", "@h3ro-dev/motion-mcp-server"],
      "env": {
        "MOTION_API_KEY": "your-api-key"
      }
    }
  }
}

Config location:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

Cursor

{
  "mcpServers": {
    "motion": {
      "command": "npx",
      "args": ["-y", "@h3ro-dev/motion-mcp-server"],
      "env": {
        "MOTION_API_KEY": "your-api-key"
      }
    }
  }
}

VS Code (with Continue)

{
  "mcpServers": {
    "motion": {
      "command": "npx",
      "args": ["-y", "@h3ro-dev/motion-mcp-server"],
      "env": {
        "MOTION_API_KEY": "your-api-key"
      }
    }
  }
}

3. Restart your AI assistant

Features

✅ All Motion APIs - Tasks, projects, workspaces, users, comments, recurring tasks, schedules
🚦 Smart Rate Limiting - Automatic handling of Motion's 12 req/3min limit
💾 Persistent State - SQLite database maintains rate limits across restarts
🔍 Clear Errors - Helpful messages for debugging
📝 Full TypeScript - Type-safe and reliable

Usage Examples

"List my tasks"
"Create task: Review budget, due Friday, high priority"
"Move task abc123 to Marketing workspace"
"Add comment to task xyz789: Waiting for approval"
"Create recurring task: Daily standup at 9am"

Tools Reference

Task Management (7 tools)

Tool	Description	Example
`motion_list_tasks`	List tasks with filters	`workspaceId`, `status`, `assigneeId`
`motion_get_task`	Get task details	`taskId`
`motion_create_task`	Create new task	`name`, `workspaceId`, `dueDate`, `priority`
`motion_update_task`	Update task	`taskId`, `status`, `priority`
`motion_delete_task`	Delete task	`taskId`
`motion_move_task`	Move to workspace	`taskId`, `workspaceId`
`motion_unassign_task`	Remove assignee	`taskId`

Project Management (5 tools)

Tool	Description	Example
`motion_list_projects`	List projects	`workspaceId`
`motion_get_project`	Get project details	`projectId`
`motion_create_project`	Create project	`name`, `workspaceId`
`motion_update_project`	Update project	`projectId`, `name`
`motion_archive_project`	Archive project	`projectId`

Other Tools (8 tools)

Tool	Description
`motion_list_workspaces`	List all workspaces
`motion_get_workspace`	Get workspace details
`motion_list_users`	List workspace users
`motion_get_current_user`	Get current user
`motion_list_comments`	List task comments
`motion_create_comment`	Add task comment
`motion_list_recurring_tasks`	List recurring tasks
`motion_create_recurring_task`	Create recurring task
`motion_delete_recurring_task`	Delete recurring task
`motion_list_schedules`	List schedules

Configuration

Variable	Required	Default	Description
`MOTION_API_KEY`	✅	-	Your Motion API key
`MOTION_BASE_URL`	❌	`https://api.usemotion.com/v1`	API endpoint
`RATE_LIMIT_WINDOW_MS`	❌	`180000`	Rate limit window (3 min)
`RATE_LIMIT_MAX_REQUESTS`	❌	`12`	Max requests per window
`DATABASE_PATH`	❌	`./motion-rate-limit.db`	SQLite database path
`DEBUG`	❌	`false`	Enable debug logging

Development

# Clone
git clone https://github.com/h3ro-dev/motion-mcp-server.git
cd motion-mcp-server

# Install
npm install

# Build
npm run build

# Test
npm test

# Run locally
MOTION_API_KEY=your-key npm start

Troubleshooting

Common Issues

"Invalid API Key"

Check API key is correct
Ensure no extra spaces
Regenerate key if needed

"Rate limit exceeded"

Server automatically handles this
Wait time shown in error
Check DATABASE_PATH is writable

"Task not found"

Verify task ID exists
Check workspace access
Task may be archived

License

MIT © h3ro-dev

Máy chủ liên quan

Kone.vc

nhà tài trợ

Monetize your AI agent with contextual product recommendations

MCP Video Converter Server

Convert video files between various formats using FFmpeg. Requires FFmpeg to be installed on the system.

Computer Control MCP

Control your computer's mouse, keyboard, and perform OCR using PyAutoGUI and RapidOCR. Works on Windows, with potential support for other platforms.

Brandfolio - Make Your Brand Machine-Readable for AI

Your brand deserves consistency across every AI interaction. Brandfolio transforms your brand identity into a format that works with AI on every platform.

floor plan generator

BuildFloorPlan is an AI floor plan generator for homeowners, interior designers, builders, and small planning teams who need to move from rough input to a reviewable layout faster. It turns short briefs, sketches, images, and PDFs into clearer floor plan outputs in seconds, supports technical 2D layouts, colored presentation-ready plans, and quick 3D previews, and helps users compare layout directions before renovation, client presentation, or internal review. It is designed for fast first drafts, supports editing and refinement workflows, and does not require CAD experience. You can start free with starter credits, and paid plans add more credits, longer history, and commercial usage options.

Itemit

A simple notes system for Itemit, built with TypeScript.

better-notion-mcp

Markdown-first Notion MCP server with 9 composite tools, 39 actions, and ~77% token reduction via tiered docs.

Open-Brain

MCP memory server that builds a knowledge graph as you capture thoughts. 16 tools. Self-hostable.

Whimsical MCP Server

Create Whimsical diagrams programmatically using Mermaid markup via the Whimsical API.

Jira MCP

MCP server for connecting AI assistants to your own Jira instance

byAir MCP

Personal Flight Tracking MCP