Obsidian MCP Tools — Casos de uso, Instalar & Demo ao vivo

Por que usar

Principais recursos

Plugin local do Obsidian + bridge MCP
Busca semântica via integração com Smart Connections
Execução de prompts do Templater a partir do Claude
CRUD completo de arquivos: leitura, escrita, adição, link e frontmatter
Suporte a notas diárias e diário
Os dados do vault nunca saem da sua máquina

Demo ao vivo

Como fica na prática

obsidian-mcp-tools.replay ▶ pronto

0/0

Instalar

Escolha seu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "obsidian-mcp-tools": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-tools"
      ]
    }
  }
}

Abra Claude Desktop → Settings → Developer → Edit Config. Reinicie após salvar.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "obsidian-mcp-tools": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-tools"
      ]
    }
  }
}

Cursor usa o mesmo esquema mcpServers que o Claude Desktop. Config de projeto vence a global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "obsidian-mcp-tools": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-tools"
      ]
    }
  }
}

Clique no ícone MCP Servers na barra lateral do Cline, depois "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "obsidian-mcp-tools": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-tools"
      ]
    }
  }
}

Mesmo formato do Claude Desktop. Reinicie o Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "obsidian-mcp-tools",
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-tools"
      ]
    }
  ]
}

O Continue usa um array de objetos de servidor em vez de um map.

~/.config/zed/settings.json

{
  "context_servers": {
    "obsidian-mcp-tools": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "obsidian-mcp-tools"
        ]
      }
    }
  }
}

Adicione em context_servers. Zed recarrega automaticamente ao salvar.

claude mcp add obsidian-mcp-tools -- npx -y obsidian-mcp-tools

Uma linha só. Verifique com claude mcp list. Remova com claude mcp remove.

Casos de uso

Usos do mundo real: Obsidian MCP Tools

Como realmente consultar seu segundo cérebro em vez de fazer grep nele

👤 Usuários de PKM no Obsidian com mais de 1.000 notas ⏱ ~20 min intermediate

Quando usar: Você sabe que escreveu sobre algo meses atrás, mas a busca por palavras-chave continua perdendo o resultado.

Pré-requisitos

Obsidian + este plugin + plugin Smart Connections — Instale ambos em Plugins da Comunidade; o Smart Connections criará o índice na primeira execução

Fluxo

Verificar o índice

Verifique se o Smart Connections terminou de criar os embeddings do meu vault. Informe o total de notas indexadas.✓ Copiado

→ Número de notas indexadas; modelo de embedding em uso
Recuperação semântica

Encontre notas relacionadas a 'por que saí do meu último emprego', mesmo que essas palavras exatas não estejam em nenhuma nota.✓ Copiado

→ 5 notas classificadas por correspondência semântica, com trechos
Compor

Sintetize essas notas em uma nota de reflexão curta. Salve em /Reflections/ com um wikilink para cada fonte.✓ Copiado

→ Nova nota criada; backlinks resolvem

Resultado: Um segundo cérebro que responde por conceitos, não por palavras-chave.

Armadilhas

A recuperação semântica traz notas pessoais sensíveis — Use a configuração excludedFolders do Obsidian no Smart Connections para pular diretórios privados

Combine com: humanizer-skill

Executar um template do Templater a partir do Claude com prompts preenchidos automaticamente

👤 Usuários avançados do Obsidian com templates ⏱ ~10 min intermediate

Quando usar: Você tem um template de 'kickoff de projeto' no Templater que faz 5 perguntas; prefere que o Claude o orquestre.

Pré-requisitos

Templater instalado com templates configurados — Plugin padrão da comunidade

Fluxo

Listar templates

Quais templates do Templater estão disponíveis?✓ Copiado

→ Lista de templates com descrições dos prompts
Executar com preenchimento automático

Execute 'project_kickoff' para um projeto chamado 'Reforma da integração Q3'. Responda automaticamente aos prompts com base no contexto.✓ Copiado

→ Nova nota criada usando o template; prompts preenchidos

Resultado: Templates executados a partir do chat em vez de um modal.

Armadilhas

Alguns comandos do Templater são assíncronos e precisam de tempo — A ferramenta MCP aguarda a conclusão — mas não encadeie muitos em uma única chamada

Construir automaticamente uma nota diária com base no calendário e nas tarefas de ontem

👤 Usuários do Obsidian focados em produtividade ⏱ ~15 min intermediate

Quando usar: Você começa cada dia editando o mesmo template de 'Diário' — automatize isso.

Fluxo

Puxar os dados de hoje

Leia a nota de ontem. Traga as tarefas incompletas. Busque os eventos de hoje via MCP google-calendar.✓ Copiado

→ Tarefas trazidas + eventos do dia identificados
Escrever o diário

Crie a nota diária de hoje em /Daily/$(date +%F).md com as seções padrão.✓ Copiado

→ Nota criada e aberta

Resultado: Nota diária pronta em 5 segundos.

Armadilhas

Trazer tarefas duplica itens se a mesma tarefa estiver em 2 dias — Deduplique pelo texto da linha antes de escrever

Combine com: google-calendar

Combinações

Combine com outros MCPs para 10× de alavancagem

obsidian-mcp-tools + google-calendar

Construir notas diárias que incluam os eventos do dia

Faça a nota de hoje. Inclua os eventos do calendário sob '## Hoje'.✓ Copiado

obsidian-mcp-tools + github

Espelhar um quadro de projeto no vault como nota

Sincronize as tarefas do projeto GitHub XYZ para /Projects/XYZ.md como uma checklist.✓ Copiado

Ferramentas

O que este MCP expõe

Ferramenta	Entradas	Quando chamar	Custo
search_semantic	query, k?	Recuperação por conceito	1 consulta ao Smart Connections
read_note	path	Buscar uma nota individual	gratuito
write_note	path, content, mode: 'create'\|'append'\|'overwrite'	Criar ou atualizar uma nota	gratuito
list_templates	(nenhum)	Descobrir o que pode ser executado	gratuito
run_templater	template_name, prompt_answers: {}	Executar um fluxo de trabalho com template	gratuito

Custo e limites

O que custa rodar

Cota de API: Local — limitado pelo serviço de embedding do Smart Connections se for baseado em nuvem
Tokens por chamada: 100 a 1500 por nota
Monetário: Gratuito (o plugin); Smart Connections tem opções local gratuita e paga na nuvem
Dica: Use a opção de embedding local no Smart Connections para evitar custo por consulta

Segurança

Permissões, segredos, alcance

Armazenamento de credenciais: Apenas plugin local; sem armazenamento remoto

Saída de dados: Local — exceto se o Smart Connections for configurado para usar embeddings na nuvem

Não conceda acesso de escrita ao Claude no vault a menos que confie nos seus prompts; use pastas de exclusão para áreas sensíveis

Solução de problemas

Erros comuns e correções

Ferramentas MCP não aparecem

Confirme que o plugin do Obsidian está habilitado e que o processo de bridge MCP está rodando

Verificar: Verifique a barra de status do plugin; reinicie o Obsidian

search_semantic não retorna nada

O job de embedding do Smart Connections pode não ter terminado ainda — verifique o progresso

Verificar: Abra o painel lateral do Smart Connections

write_note falha com 'path outside vault'

Os caminhos são relativos à raiz do vault; não use caminhos absolutos

Alternativas

Obsidian MCP Tools vs. outros

Alternativa	Quando usar	Troca
ergut/mcp-logseq	Você usa Logseq em vez de Obsidian	Ecossistema diferente; mesma ideia
AgriciDaniel/claude-obsidian (skill)	Você quer um fluxo de trabalho no formato skill sobre I/O de arquivos	O skill é de mais alto nível; este MCP são os blocos de construção

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills