Motion

Gerencie tarefas e projetos no Motion usando assistentes de IA.

Documentaçã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)
FerramentaDescriçãoExemplo
motion_list_tasksListar tarefas com filtrosworkspaceId, status, assigneeId
motion_get_taskObter detalhes da tarefataskId
motion_create_taskCriar nova tarefaname, workspaceId, dueDate, priority
motion_update_taskAtualizar tarefataskId, status, priority
motion_delete_taskExcluir tarefataskId
motion_move_taskMover para workspacetaskId, workspaceId
motion_unassign_taskRemover responsáveltaskId
Gerenciamento de Projetos (5 ferramentas)
FerramentaDescriçãoExemplo
motion_list_projectsListar projetosworkspaceId
motion_get_projectObter detalhes do projetoprojectId
motion_create_projectCriar projetoname, workspaceId
motion_update_projectAtualizar projetoprojectId, name
motion_archive_projectArquivar projetoprojectId
Outras Ferramentas (8 ferramentas)
FerramentaDescrição
motion_list_workspacesListar todos os workspaces
motion_get_workspaceObter detalhes do workspace
motion_list_usersListar usuários do workspace
motion_get_current_userObter usuário atual
motion_list_commentsListar comentários da tarefa
motion_create_commentAdicionar comentário à tarefa
motion_list_recurring_tasksListar tarefas recorrentes
motion_create_recurring_taskCriar tarefa recorrente
motion_delete_recurring_taskExcluir tarefa recorrente
motion_list_schedulesListar agendas

Configuração

VariávelObrigatórioPadrãoDescrição
MOTION_API_KEY-Sua chave de API do Motion
MOTION_BASE_URLhttps://api.usemotion.com/v1Endpoint da API
RATE_LIMIT_WINDOW_MS180000Janela de limite de taxa (3 min)
RATE_LIMIT_MAX_REQUESTS12Máximo de solicitações por janela
DATABASE_PATH./motion-rate-limit.dbCaminho do banco de dados SQLite
DEBUGfalseHabilitar 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

Links