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

Por que usar

Principais recursos

Oito ferramentas que abrangem notas, tags, frontmatter e pesquisa
Modos de atualização anexar/anexar/substituir — os agentes não precisam regenerar arquivos inteiros
Operações de nível-chave do frontmatter atômico
Pesquisa difusa global em todo o cofre
Camada de cache para leituras repetidas mais rápidas

Demo ao vivo

Como fica na prática

obsidian-mcp-server.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-server": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-server"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "<from Local REST API plugin>",
        "OBSIDIAN_BASE_URL": "http://127.0.0.1:27123"
      }
    }
  }
}

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

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

{
  "mcpServers": {
    "obsidian-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-server"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "<from Local REST API plugin>",
        "OBSIDIAN_BASE_URL": "http://127.0.0.1:27123"
      }
    }
  }
}

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-server": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-server"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "<from Local REST API plugin>",
        "OBSIDIAN_BASE_URL": "http://127.0.0.1:27123"
      }
    }
  }
}

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

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "obsidian-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-server"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "<from Local REST API plugin>",
        "OBSIDIAN_BASE_URL": "http://127.0.0.1:27123"
      }
    }
  }
}

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

~/.continue/config.json

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

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

~/.config/zed/settings.json

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

Adicione em context_servers. Zed recarrega automaticamente ao salvar.

claude mcp add obsidian-mcp-server -- npx -y obsidian-mcp-server

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

Casos de uso

Usos do mundo real: Obsidian MCP Server

Capture ideias nas anotações diárias de hoje de qualquer cliente MCP

👤 Usuários Obsidian que vivem no chat ⏱ ~5 min beginner

Quando usar: Você está no meio de uma conversa com Claude e deseja que um pensamento seja salvo em seu cofre, sem precisar trocar de aplicativo.

Pré-requisitos

Obsidian com plug-in API REST local ativado — Plug-ins da comunidade → instale 'API REST local' → copie a chave da API
Cliente MCP configurado com OBSIDIAN_API_KEY + OBSIDIAN_BASE_URL — Veja bloco de configuração; O URL base geralmente é http://127.0.0.1:27123

Fluxo

Verifique se a nota diária existe

Liste as notas em Daily/2026-04-17.md.✓ Copiado

→ Caminho do arquivo confirmado ou 'não encontrado'
Anexar a captura

Anexe '- Idéia: tente X para o bug de cache' em Daily/2026-04-17.md.✓ Copiado

→ Anexação confirmada sem substituir entradas anteriores

Resultado: Um diário em execução que os agentes podem adicionar, nunca atrapalhar.

Armadilhas

Usando o modo de substituição quando você quis dizer anexar — Sempre o padrão é anexar ou preceder as notas diárias; salvar substituição para novos rascunhos

Combine com: filesystem

Transforme uma semana de anotações em um documento de revisão

👤 Trabalhadores do conhecimento fazendo revisões semanais ⏱ ~20 min intermediate

Quando usar: Você precisa de uma síntese de sexta-feira com as notas dispersas da semana.

Pré-requisitos

Notas marcadas ou datadas — Use #weekly ou uma pasta Daily/

Fluxo

Pesquise as notas da semana

Pesquisa global: notas modificadas esta semana em Diário/.✓ Copiado

→ Lista de 5 a 7 caminhos de arquivo
Leia cada

Leia cada nota diária e faça um resumo por tema.✓ Copiado

→ Marcadores temáticos, não concatenação bruta
Escreva a avaliação

Escreva o resumo em Reviews/2026-W16.md; adicionar status de frontmatter: revisão, tags: [semanalmente].✓ Copiado

→ Novo arquivo com frontmatter adequado

Resultado: Uma nota de revisão semanal construída a partir da matéria-prima, sem copiar e colar manualmente.

Combine com: github

Consolide tags confusas em um cofre

👤 Vaults que cresceram organicamente e agora têm variantes #Work / #work / #WORK ⏱ ~30 min intermediate

Quando usar: A lista de tags é muito longa devido a duplicatas e quase duplicatas.

Fluxo

Listar tags atuais

Use obsidian_manage_tags para listar todas as tags classificadas por uso.✓ Copiado

→ As contagens de tags revelam as duplicatas
Proponha um mapeamento

Proponha um conjunto canônico e um mapeamento do antigo → novo.✓ Copiado

→ Tabela pequena e revisável
Aplicar em lote

Depois de confirmar, renomeie as tags no vault usando o mapeamento.✓ Copiado

→ Operações de tags resumidas por nota

Resultado: Taxonomia de tags limpa na qual você pode realmente navegar.

Armadilhas

Reescrevendo centenas de notas de uma só vez, sem backup — Confirme o vault para o git primeiro; revise a diferença

Combine com: git

Coloque recortes da web em uma caixa de entrada de pesquisa e marque-os automaticamente

👤 Pesquisadores, analistas, qualquer pessoa com hábito de tosquiar ⏱ ~15 min beginner

Quando usar: A caixa de entrada/pasta se acumula mais rápido do que você pode processá-la.

Pré-requisitos

Uma caixa de entrada/pasta designada — Crie-o no cofre

Fluxo

Listar caixa de entrada

Liste notas não marcadas em Caixa de entrada/.✓ Copiado

→ Caminhos de itens pendentes
Classificar e etiquetar

Para cada um, sugira de 1 a 3 tags com base no conteúdo e aplique com obsidian_manage_tags.✓ Copiado

→ Tags adicionadas atomicamente via frontmatter

Resultado: A caixa de entrada permanece pequena; novos clipes são organizados automaticamente.

Combine com: fetch

Combinações

Combine com outros MCPs para 10× de alavancagem

obsidian-mcp-server + fetch

Recorte um URL com fetch e escreva-o na Caixa de entrada/

Busque https://... e salve um resumo limpo em Inbox/YYYY-MM-DD-title.md com o frontmatter adequado.✓ Copiado

obsidian-mcp-server + github

Copie os resumos de PR mesclados em Projects/<repo>.md

Procure PRs mesclados esta semana e anexe um resumo em ## Semana 16 em Projects/acme-api.md.✓ Copiado

obsidian-mcp-server + git

Versione seu vault e confirme alterações em lote

Após a limpeza da tag, execute git diff no vault e faça um resumo antes de confirmar.✓ Copiado

Ferramentas

O que este MCP expõe

Ferramenta	Entradas	Quando chamar
obsidian_read_note	path: str	Leia uma nota específica antes de editá-la ou resumi-la
obsidian_update_note	path: str, content: str, mode: 'append'\|'prepend'\|'overwrite'	Adicionar ou substituir o conteúdo da nota – o padrão é anexar, a menos que seja reescrito
obsidian_search_replace	path: str, find: str, replace: str	Edições direcionadas em notas sem regenerar o arquivo inteiro
obsidian_global_search	query: str, filters?	Encontre notas em todo o cofre
obsidian_list_notes	folder?: str	Enumerar notas em uma pasta antes das operações em lote
obsidian_manage_frontmatter	path: str, op: 'get'\|'set'\|'delete', key?: str, value?: any	Mudanças atômicas de frontmatter de nível-chave
obsidian_manage_tags	path?: str, op: 'list'\|'add'\|'remove'	Tag operações de higiene e taxonomia
obsidian_delete_note	path: str	Remover uma nota — permanente, sem desfazer

Custo e limites

O que custa rodar

Cota de API: Nenhuma API externa – API REST local é executada em seu Mac/PC
Tokens por chamada: Tamanho de nota; típico 200–3000
Monetário: Livre
Dica: Prefira global_search + leitura sob demanda em vez de listar pastas inteiras em massa no contexto.

Segurança

Permissões, segredos, alcance

Armazenamento de credenciais: OBSIDIAN_API_KEY apenas em env var - nunca confirmado. Trate-o como um token de administrador local do seu cofre.

Saída de dados: Todo o tráfego é localhost → Obsidian Local REST API. Nenhuma chamada na nuvem deste servidor.

O plugin Local REST API expõe seu cofre em uma porta HTTP local; vincule-se apenas a 127.0.0.1 e mantenha o HTTPS desativado apenas para localhost.
Um invasor que atinge seu OBSIDIAN_API_KEY obtém leitura/gravação completa no cofre – gire se você suspeitar de vazamento.

Solução de problemas

Erros comuns e correções

ECONNREFUSADO 127.0.0.1:27123

Obsidian não está em execução ou o plug-in da API REST local está desativado. Abra Obsidian e habilite o plugin.

Verificar: curl -H 'Authorization: Bearer $OBSIDIAN_API_KEY' http://127.0.0.1:27123/vault/

401 Não Autorizado

OBSIDIAN_API_KEY não corresponde à chave atual do plugin. Copie o valor das configurações do plugin novamente.

Verificar: Plugin Settings → Local REST API → copy the API key

404 em um arquivo conhecido

O caminho é relativo ao vault e diferencia maiúsculas de minúsculas – confirme com obsidian_list_notes.

Verificar: obsidian_list_notes folder='Daily'

Alternativas

Obsidian MCP Server vs. outros

Alternativa	Quando usar	Troca
obsidian-plugin-skill	Você quer que Claude ajude a criar plug-ins Obsidian, não a editar o conteúdo do vault	Escopo diferente
filesystem MCP	Você está bem com operações de arquivo bruto e não precisa de APIs frontmatter/tag com reconhecimento de Obsidian	Você perde operações de tag atômica/frontmatter

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills