Motion
Gerencie tarefas e projetos no Motion usando assistentes de IA.
GitHub
2
Experimente este MCPPatrocinadoDocumentação
Motion MCP Server
Conecte assistentes de IA ao Motion para gerenciamento de tarefas e projetos.
Instalação
npm install -g @h3ro-dev/motion-mcp-server
Configuração Rápida
1. Obtenha a Chave da API do Motion
Motion → Configurações → API e Integrações → Criar Nova Chave de API
2. Configurar
Claude Desktop
{
"mcpServers": {
"motion": {
"command": "npx",
"args": ["-y", "@h3ro-dev/motion-mcp-server"],
"env": {
"MOTION_API_KEY": "your-api-key"
}
}
}
}
Localização da configuração:
- 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. Reinicie seu assistente de IA
Recursos
- ✅ Todas as APIs do Motion - Tarefas, projetos, workspaces, usuários, comentários, tarefas recorrentes, agendas
- 🚦 Limitação Inteligente de Taxa - Tratamento automático do limite de 12 req/3min do Motion
- 💾 Estado Persistente - Banco de dados SQLite mantém os limites de taxa entre reinicializações
- 🔍 Erros Claros - Mensagens úteis para depuração
- 📝 TypeScript Completo - Type-safe e confiável
Exemplos de Uso
"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"
Referência de Ferramentas
Gerenciamento de Tarefas (7 ferramentas)
| Ferramenta | Descrição | Exemplo |
|---|---|---|
motion_list_tasks | Listar tarefas com filtros | workspaceId, status, assigneeId |
motion_get_task | Obter detalhes da tarefa | taskId |
motion_create_task | Criar nova tarefa | name, workspaceId, dueDate, priority |
motion_update_task | Atualizar tarefa | taskId, status, priority |
motion_delete_task | Excluir tarefa | taskId |
motion_move_task | Mover para workspace | taskId, workspaceId |
motion_unassign_task | Remover responsável | taskId |
Gerenciamento de Projetos (5 ferramentas)
| Ferramenta | Descrição | Exemplo |
|---|---|---|
motion_list_projects | Listar projetos | workspaceId |
motion_get_project | Obter detalhes do projeto | projectId |
motion_create_project | Criar projeto | name, workspaceId |
motion_update_project | Atualizar projeto | projectId, name |
motion_archive_project | Arquivar projeto | projectId |
Outras Ferramentas (8 ferramentas)
| Ferramenta | Descrição |
|---|---|
motion_list_workspaces | Listar todos os workspaces |
motion_get_workspace | Obter detalhes do workspace |
motion_list_users | Listar usuários do workspace |
motion_get_current_user | Obter usuário atual |
motion_list_comments | Listar comentários da tarefa |
motion_create_comment | Adicionar comentário à tarefa |
motion_list_recurring_tasks | Listar tarefas recorrentes |
motion_create_recurring_task | Criar tarefa recorrente |
motion_delete_recurring_task | Excluir tarefa recorrente |
motion_list_schedules | Listar agendas |
Configuração
| Variável | Obrigatório | Padrão | Descrição |
|---|---|---|---|
MOTION_API_KEY | ✅ | - | Sua chave de API do Motion |
MOTION_BASE_URL | ❌ | https://api.usemotion.com/v1 | Endpoint da API |
RATE_LIMIT_WINDOW_MS | ❌ | 180000 | Janela de limite de taxa (3 min) |
RATE_LIMIT_MAX_REQUESTS | ❌ | 12 | Máximo de solicitações por janela |
DATABASE_PATH | ❌ | ./motion-rate-limit.db | Caminho do banco de dados SQLite |
DEBUG | ❌ | false | Habilitar registro de depuração |
Desenvolvimento
# 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
Solução de Problemas
Problemas Comuns
"Chave de API inválida"
- Verifique se a chave de API está correta
- Certifique-se de que não há espaços extras
- Regere a chave se necessário
"Limite de taxa excedido"
- O servidor lida com isso automaticamente
- O tempo de espera é exibido no erro
- Verifique se
DATABASE_PATHé gravável
"Tarefa não encontrada"
- Verifique se o ID da tarefa existe
- Verifique o acesso ao workspace
- A tarefa pode estar arquivada
Licença
MIT © h3ro-dev