F
licenseNot graded
qualityD
maintenanceConnects Claude.ai to your Motion workspace, enabling task and project management via natural language.
-
Motion MCP Server
by h3ro-dev
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Motion MCP Servercreate task: Review budget, due Friday, high priority"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Motion MCP Server
Connect AI assistants to Motion for task and project management.
Installation
npm install -g @h3ro-dev/motion-mcp-serverRelated MCP server: Motion MCP Server
Quick Setup
1. Get Motion API Key
Motion → Settings → API & Integrations → Create New API Key
2. Configure
{
"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.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.jsonLinux:
~/.config/Claude/claude_desktop_config.json
{
"mcpServers": {
"motion": {
"command": "npx",
"args": ["-y", "@h3ro-dev/motion-mcp-server"],
"env": {
"MOTION_API_KEY": "your-api-key"
}
}
}
}{
"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
Tool | Description | Example |
| List tasks with filters |
|
| Get task details |
|
| Create new task |
|
| Update task |
|
| Delete task |
|
| Move to workspace |
|
| Remove assignee |
|
Tool | Description | Example |
| List projects |
|
| Get project details |
|
| Create project |
|
| Update project |
|
| Archive project |
|
Tool | Description |
| List all workspaces |
| Get workspace details |
| List workspace users |
| Get current user |
| List task comments |
| Add task comment |
| List recurring tasks |
| Create recurring task |
| Delete recurring task |
| List schedules |
Configuration
Variable | Required | Default | Description |
| ✅ | - | Your Motion API key |
| ❌ |
| API endpoint |
| ❌ |
| Rate limit window (3 min) |
| ❌ |
| Max requests per window |
| ❌ |
| SQLite database path |
| ❌ |
| 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 startTroubleshooting
"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_PATHis writable
"Task not found"
Verify task ID exists
Check workspace access
Task may be archived
License
MIT © h3ro-dev
Links
This server cannot be deployed
Maintenance
ActivityInactive
ResponsivenessNo issues
Related MCP Connectors
Manage tasks, Focus Zone, notes, projects, and task history from compatible AI assistants.
Task management for people and AI agents, with scoped OAuth access to issues, projects, and docs.
Create and manage MeisterTask projects, tasks, and notes from your AI assistant.
- DartOAuthcom.dartai
AI-native project management for tasks, docs, collaboration, and agents.
Related MCP Servers
- AlicenseBqualityCmaintenanceEnables natural language management of Motion tasks, projects, schedules, and more via the Model Context Protocol, integrating with LLMs like Claude and ChatGPT.10Apache 2.0
- FlicenseNot gradedqualityBmaintenanceEnables interaction with the Motion API for task and project management, including listing, creating, updating, and deleting tasks, projects, comments, and workspaces.-
- AlicenseNot gradedqualityCmaintenanceEnables AI assistants to manage Motion tasks, projects, workspaces, schedules, comments, custom fields, and recurring tasks through natural-language conversation via the Model Context Protocol.Apache 2.0