Scatty MCP
Sua Scatty dentro do Claude e do Codex
Conecte o servidor MCP da Scatty e peça em conversa: "o que tenho hoje?", "cria uma tarefa para ligar pro dentista amanhã às 15h", "quebra essa tarefa em etapas", "move a reunião das 10h para as 11h".
Conectar
Endereço do servidor (Streamable HTTP, com OAuth):
https://scatty-api.guilherme-dea.workers.dev/mcpA Scatty está em beta fechado: só contas liberadas conseguem entrar.
Claude (web, desktop e celular)
- Configurações → Conectores → Adicionar conector personalizado.
- Nome:
Scatty. URL: o endereço acima. - Clique em Conectar, permita o acesso e entre na sua conta Scatty.
Claude Code
claude mcp add --transport http scatty https://scatty-api.guilherme-dea.workers.dev/mcp
Depois, dentro do Claude Code, rode /mcp e escolha scatty → Authenticate.
Codex (CLI e app)
codex mcp add scatty --url https://scatty-api.guilherme-dea.workers.dev/mcp
codex mcp login scatty
O navegador abre para você permitir e entrar.
Outros clientes MCP
Qualquer cliente com MCP remoto e OAuth 2.1 funciona (Cursor, VS Code, ChatGPT…): use o mesmo endereço. A descoberta é automática (/.well-known/oauth-protected-resource/mcp), com registro dinâmico de cliente e PKCE.
Login e segurança
- Você aprova cada app. A tela "Permitir que X use sua Scatty?" mostra quem pede e para onde o acesso vai.
- Mesma conta do app. O login é o da Scatty (app.scatty.app); a senha nunca passa pelo assistente.
- Tokens guardados só como hash, e o acesso vale enquanto você usa (expira depois de 60 dias parado).
- Para desconectar, remova o conector no Claude ou rode
codex mcp logout scatty.
Ferramentas
São 34 ferramentas. Elas seguem as mesmas regras do app: limite de adiar, tarefas recorrentes, agendas Google e iPhone.
Visão geral
get_today | O dia de hoje: eventos, compromissos com horário, tarefas abertas, datas importantes chegando e lembretes rápidos. |
|---|---|
get_now | A uma tarefa que a Scatty sugere fazer agora (opcional: energy low/med/high). |
Tarefas
list_tasks | Lista tarefas: status open (padrão), done ou all; filtro por listId, por texto (query) e por area (Pessoal ou Trabalho). |
|---|---|
get_task | Uma tarefa com todas as etapas. |
create_task | Cria: title e, se quiser, dueAt (data), scheduledAt (horário fixo), priority, kind (commitment = pequeno mas difícil), estimateMin, energy, listId, personId, recurrence, fixed, area (personal = Pessoal, work = Trabalho). |
update_task | Muda só o que for enviado; status done/later/now; snooze para adiar (com os limites do app). |
complete_task | Conclui. Uma recorrente pula para a próxima vez. |
delete_task | Apaga (arquiva) a tarefa. |
Etapas
add_step | Adiciona uma etapa a uma tarefa (title, doneWhen, estimateMin, note; parentStepId para uma parte dentro de uma etapa). |
|---|---|
update_step | Muda texto, estimativa, nota ou status (done, todo, dropped = não precisou). |
delete_step | Apaga a etapa (e as partes dela). |
Listas
list_lists | Listas de tarefas. |
|---|---|
create_list · rename_list | Cria ou renomeia (name). |
delete_list | Apaga a lista; as tarefas ficam, sem lista. |
Agenda (Google e iPhone)
list_calendars | Cada conta Google (e-mail) com suas agendas e a tag Pessoal/Trabalho, e a sincronização do iPhone. |
|---|---|
set_calendar_area | Marca uma conta Google ou uma agenda do iPhone como Pessoal ou Trabalho. Os eventos dela herdam a tag. |
list_events | Eventos de todas as contas entre from e to (padrão: próximos 7 dias; máximo 6 semanas). Cada evento diz a conta, a agenda e a origem. |
get_event | Um evento com descrição e convidados. |
create_event | Cria no Google: title, start, end (padrão 1 h), allDay, location, description, accountId/calendarId (padrão: agenda principal da primeira conta). |
update_event | Muda título, horário, local ou descrição. Mover o início sem fim mantém a duração. Eventos do iPhone mudam na Scatty na hora e no iPhone quando o app abrir lá. |
delete_event | Apaga um evento do Google (só aquela ocorrência). Eventos do iPhone só se apagam no iPhone. |
Notas
list_notes | Notas, mais novas primeiro; busca por texto (query). |
|---|---|
get_note | Uma nota. |
create_note | Salva o texto como está (primeira linha = título). A Scatty organiza depois. |
update_note | Muda texto, pinned ou category. |
delete_note | Apaga a nota. |
Lembretes rápidos
list_quick_reminders | Lembretes que somem sozinhos (no máximo 24 h). |
|---|---|
add_quick_reminder | Cria (text; ttlMin para sumir antes). |
delete_quick_reminder | Remove. |
Pessoas e datas
list_people | Pessoas, datas importantes e o que está chegando. |
|---|---|
create_person · delete_person | Adiciona (name, relation) ou apaga uma pessoa. |
add_important_date | Aniversário, bodas…: kind, month, day, year, label, personId. Avisa 7, 1 e 0 dias antes. |
delete_important_date | Apaga a data. |
Revisar
get_review | O que passou do horário sem ser marcado (tarefas, tempo reservado, eventos) e o que já foi revisado. |
|---|---|
review_item | Feito ou não feito; se não, o motivo (reason, note) e o que fazer: reschedule com retryAt, unschedule, remove, skip ou keep. |
get_review_patterns | Padrões: feitos x não feitos, motivos, período do dia e dia da semana em que mais escapa, o que se repete. |
Horários
Datas e horas entram em ISO 8601. Sem fuso, valem no seu fuso: 2026-11-02T15:30. Uma data sozinha (2026-11-02) vale como meia-noite. Também aceita epoch em ms. As respostas vêm em ISO com fuso (2026-11-02T15:30:00-03:00), e eventos de dia inteiro vêm como datas, com o fim exclusivo.
Skill
A skill ensina o assistente a usar a Scatty do jeito certo. Ele começa pelo get_today, pergunta em qual conta Google criar o evento e quebra tarefas grandes em etapas pequenas. Também confirma antes de apagar e responde curto, uma coisa por vez.
Claude Code
mkdir -p ~/.claude/skills/scatty
curl -fsSL https://scatty.app/mcp/SKILL.md -o ~/.claude/skills/scatty/SKILL.md
Codex
mkdir -p ~/.codex/skills/scatty
curl -fsSL https://scatty.app/mcp/SKILL.md -o ~/.codex/skills/scatty/SKILL.md
Claude (web e desktop)
Baixe o SKILL.md, coloque numa pasta scatty, compacte em .zip e envie em Configurações → Capacidades → Skills.
Ver o conteúdo
scatty.app/mcp/SKILL.md: é texto simples e pode ser adaptado.
Exemplos
- "O que tenho hoje? Qual a uma coisa que eu devia fazer agora?"
- "Cria uma tarefa: pagar o boleto da escola até sexta."
- "Toda quarta às 17h30 eu busco a Ana na natação: cria isso como rotina."
- "Quebra 'organizar a mudança' em etapas pequenas."
- "O que tenho na agenda do trabalho semana que vem?"
- "Move a reunião de amanhã das 10h para as 11h."
- "Anota: ideia de post sobre rotina com TDAH…"
- "Quando é o aniversário da minha mãe? Me lembra uma semana antes."