yabadoo-mcp 0.3.0

MCP Server para o Yabadoo — segundo cérebro pessoal conectado ao Claude

yabadoo-mcp

MCP Server oficial do Yabadoo — conecta o Claude ao seu segundo cérebro pessoal.

O que é?

Com este plugin, o Claude passa a ter acesso direto ao seu cérebro no Yabadoo:

• Busca memórias — encontra documentos, notas, decisões e memórias pelo conteúdo
• Explora o grafo — vê as conexões Zettelkasten entre seus temas e projetos (aceita nome legível)
• Consulta entidades — dossiê de pessoas, empresas e projetos (fatos, linha do tempo, relações)
• Busca por relação — pares de entidades ligados por um vínculo ("quem é sócio de quem?")
• Lê action items — acessa suas tarefas pendentes e em andamento
• Cria tarefas — registra novos action items direto pelo Claude
• Vê lembretes — consulta agendamentos e automações ativas
• Captura pensamentos — envia notas e ideias para o Brain Agent processar e armazenar
• Lê o diário — acessa as entradas recentes do seu diário pessoal
• Consulta o inbox — lista capturas brutas ainda não processadas (WhatsApp, web, desktop)

Instalação

pip install yabadoo-mcp
# ou, sem instalar:
uvx yabadoo-mcp

Configuração

1. Gere uma API Key

Acesse yabadoo.io → Settings → API Keys → Gerar nova key.

Copie a chave gerada (ela só é exibida uma vez).

2. Configure o Claude Desktop

Edite ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "yabadoo": {
      "command": "uvx",
      "args": ["yabadoo-mcp"],
      "env": {
        "YABADOO_API_URL": "https://api.yabadoo.io",
        "YABADOO_API_KEY": "sk-yaba-sua-chave-aqui"
      }
    }
  }
}

Após salvar, reinicie o Claude Desktop. As tools do Yabadoo aparecerão automaticamente.

3. Configure o Claude Code (CLI)

claude mcp add yabadoo \
  --env YABADOO_API_URL=https://api.yabadoo.io \
  --env YABADOO_API_KEY=sk-yaba-sua-chave-aqui \
  -- uvx yabadoo-mcp

Ou adicione ao .mcp.json do projeto (compartilhável via git):

{
  "mcpServers": {
    "yabadoo": {
      "command": "uvx",
      "args": ["yabadoo-mcp"],
      "env": {
        "YABADOO_API_URL": "https://api.yabadoo.io",
        "YABADOO_API_KEY": "sk-yaba-sua-chave-aqui"
      }
    }
  }
}

Modo remoto (Claude.ai web)

Para usar via Claude.ai, prefira o servidor SSE oficial embutido na API do Yabadoo (não precisa rodar nada local). Se ainda assim quiser expor este pacote via HTTP:

YABADOO_API_KEY=sk-yaba-... yabadoo-mcp --http --port 8001

Atenção: o modo HTTP não tem autenticação própria — qualquer pessoa que alcance a porta opera o seu cérebro com a API key configurada. O servidor binda em 127.0.0.1 por padrão; só use --host 0.0.0.0 (ou um túnel público) atrás de uma camada de autenticação sua.

Depois adicione http://localhost:8001/sse em Claude.ai → Settings → Integrations.

Tools disponíveis

Tool	O que faz
buscar_memorias	Busca cross-layer: docs, memórias, action items e grafo
buscar_grafo	Conexões Zettelkasten a partir de termo, título, tag ou node_key
consultar_entidade	Dossiê de pessoa/empresa/projeto: fatos + timeline + relações
consultar_eventos	Reuniões/eventos por período ISO e/ou tema, com participantes e doc de origem
buscar_por_relacao	Pares de entidades por verbo de relação (sócio, mentor...)
listar_action_items	Tarefas por status (pendente/em_andamento/concluido)
criar_action_item	Cria nova tarefa com prioridade e data
listar_lembretes	Agendamentos e automações ativas
capturar_pensamento	Envia mensagem ao Brain Agent para processar (suporta session_id para follow-up)
buscar_diario	Entradas recentes do diário pessoal
buscar_inbox	Capturas brutas (não processadas) filtrando por status, canal, tipo ou conteúdo

Variáveis de ambiente

Variável	Descrição	Padrão
YABADOO_API_KEY	Sua API key (obrigatório)	—
YABADOO_API_URL	URL da API	http://localhost:8000
YABADOO_API_TIMEOUT	Override global do timeout HTTP, em segundos	30 (captura: 150)

Desenvolvimento local

cd apps/mcp
uv sync --extra test
uv run pytest tests/ -v

# rodar contra a API local
YABADOO_API_KEY=sk-yaba-... YABADOO_API_URL=http://localhost:8000 uv run yabadoo-mcp

Instalação direto do repositório (sem PyPI):

uvx --from "git+https://github.com/HENRIQUE4345/yabadoo-brain#subdirectory=apps/mcp" yabadoo-mcp