Obsidian
Você gerencia o vault do Obsidian do usuário via servidor MCP obsidian.
Pré-requisito e degradação
Path A — MCP obsidian conectado: use as tools diretamente.
Path B — tools falhando ou MCP ausente: não simule conteúdo de nota. O
"servidor" é o próprio app Obsidian rodando localmente com o plugin
Local REST API ativado — não é um serviço remoto sempre disponível. Uma
falha quase sempre significa Obsidian fechado ou plugin desativado,
não config ausente. Diagnostique com
${CLAUDE_PLUGIN_ROOT}/scripts/check-setup.sh e aponte
/pwdev-obsidian:init. Env var nova só vale após reiniciar a sessão.
Mapa de intenção → tool
| Intenção |
Tool |
| Ler nota inteira |
vault_read |
| Ler só uma seção/frontmatter |
vault_read com targetType+target — economiza contexto vs. ler o arquivo inteiro |
| Descobrir estrutura antes de editar |
vault_get_document_map (headings, block ids, frontmatter keys, version) — sempre antes de um vault_patch targeted |
| Criar nota nova / sobrescrever inteira |
vault_write — sobrescreve sem aviso; confirmar se o arquivo já existir |
| Acrescentar ao fim |
vault_append — cria se não existir |
| Editar heading/block/frontmatter específico |
vault_patch (replace|prepend|append|delete) |
| Adicionar/remover tag |
vault_patch em targetType: "frontmatter", target: "tags" (ver references/mcp-tools.md) |
| Renomear/mover |
vault_move |
| Duplicar |
vault_copy |
| Apagar |
vault_delete — vai para lixeira por padrão; permanent: true é irreversível |
| Listar pasta |
vault_list |
| Buscar por tag/frontmatter/data/path |
search_query (JsonLogic) |
| Buscar texto livre por relevância |
search_simple |
| Tags do vault + contagem |
tag_list |
| Arquivo aberto no editor |
active_file_get_path |
| Abrir arquivo na UI |
open_file |
| Rodar comando da paleta |
command_list → command_execute |
Parâmetros exatos, scopes e pegadinhas: ${CLAUDE_PLUGIN_ROOT}/references/mcp-tools.md.
Resource MCP
obsidian://local-rest-api/openapi.yaml — spec OpenAPI completa da REST API
subjacente, útil quando o comportamento de uma tool não estiver claro.
Regras
- Mutação com impacto sempre com confirmação antes de executar:
sobrescrever nota existente (
vault_write), vault_delete
(especialmente permanent: true), vault_move/vault_copy sobre destino
existente, e command_execute (pode disparar qualquer comando registrado,
inclusive de outros plugins instalados — sem preview do efeito).
- Nunca reconstruir manualmente um heading/block id retornado por
vault_get_document_map — copiar verbatim (pode ter sufixo de
desambiguação não-imprimível para duplicatas).
- Em
vault_patch, níveis de heading no content são relativos ao
target — não conte #s absolutos.
- Leia
.claude/pwdev-obsidian-context.md (vault, pastas, convenções de
tag, regra de confirmação) antes de perguntar o que já está registrado.
- Conteúdo criado no vault (título, corpo, frontmatter) segue o idioma do
vault/usuário — pergunte se houver dúvida, nunca traduza sem pedir.
Fluxos recomendados
- Criar nota: perguntar pasta/título/tags → montar conteúdo → confirmar
→
vault_write.
- Editar seção existente:
vault_get_document_map → vault_patch
targeted (com ifMatch quando a edição for sensível a concorrência).
- Panorama do vault: ver
/pwdev-obsidian:vault.
Limites
- Sem acesso a anexos binários (imagens, PDFs) — só arquivos markdown.
- Um único vault por vez: o que estiver aberto no Obsidian no momento da
chamada.
- Sem sincronização nem gestão de plugins do Obsidian.
- Panorama agregado e persistido →
/pwdev-obsidian:vault.
1---2name: obsidian3description: >4 Leitura, escrita e edição estruturada de notas, busca, tags, arquivo ativo5 e comandos da paleta no Obsidian via MCP (plugin Local REST API). Use6 quando o usuário disser "Obsidian", "vault", "nota", "anotação", "criar7 nota", "buscar nota", "tag", "daily note", "frontmatter", "abrir arquivo8 no Obsidian", ou pedir para ler/editar/organizar conteúdo do vault.9metadata:10 source: https://skillmd.com/skills/pwdev-solucoes/obsidian11 version: 1.0.012---1314# Obsidian1516Você gerencia o vault do Obsidian do usuário via servidor MCP `obsidian`.1718## Pré-requisito e degradação1920**Path A — MCP `obsidian` conectado**: use as tools diretamente.2122**Path B — tools falhando ou MCP ausente**: não simule conteúdo de nota. O23"servidor" é o **próprio app Obsidian** rodando localmente com o plugin24Local REST API ativado — não é um serviço remoto sempre disponível. Uma25falha quase sempre significa **Obsidian fechado** ou **plugin desativado**,26não config ausente. Diagnostique com27`${CLAUDE_PLUGIN_ROOT}/scripts/check-setup.sh` e aponte28`/pwdev-obsidian:init`. Env var nova só vale após reiniciar a sessão.2930## Mapa de intenção → tool3132| Intenção | Tool |33|---|---|34| Ler nota inteira | `vault_read` |35| Ler só uma seção/frontmatter | `vault_read` com `targetType`+`target` — economiza contexto vs. ler o arquivo inteiro |36| Descobrir estrutura antes de editar | `vault_get_document_map` (headings, block ids, frontmatter keys, `version`) — **sempre antes de um `vault_patch` targeted** |37| Criar nota nova / sobrescrever inteira | `vault_write` — **sobrescreve sem aviso**; confirmar se o arquivo já existir |38| Acrescentar ao fim | `vault_append` — cria se não existir |39| Editar heading/block/frontmatter específico | `vault_patch` (`replace`\|`prepend`\|`append`\|`delete`) |40| Adicionar/remover tag | `vault_patch` em `targetType: "frontmatter"`, `target: "tags"` (ver `references/mcp-tools.md`) |41| Renomear/mover | `vault_move` |42| Duplicar | `vault_copy` |43| Apagar | `vault_delete` — vai para lixeira por padrão; `permanent: true` é irreversível |44| Listar pasta | `vault_list` |45| Buscar por tag/frontmatter/data/path | `search_query` (JsonLogic) |46| Buscar texto livre por relevância | `search_simple` |47| Tags do vault + contagem | `tag_list` |48| Arquivo aberto no editor | `active_file_get_path` |49| Abrir arquivo na UI | `open_file` |50| Rodar comando da paleta | `command_list` → `command_execute` |5152Parâmetros exatos, scopes e pegadinhas: `${CLAUDE_PLUGIN_ROOT}/references/mcp-tools.md`.5354## Resource MCP5556`obsidian://local-rest-api/openapi.yaml` — spec OpenAPI completa da REST API57subjacente, útil quando o comportamento de uma tool não estiver claro.5859## Regras6061- **Mutação com impacto sempre com confirmação antes de executar**:62 sobrescrever nota existente (`vault_write`), `vault_delete`63 (especialmente `permanent: true`), `vault_move`/`vault_copy` sobre destino64 existente, e `command_execute` (pode disparar qualquer comando registrado,65 inclusive de outros plugins instalados — sem preview do efeito).66- **Nunca reconstruir manualmente** um heading/block id retornado por67 `vault_get_document_map` — copiar verbatim (pode ter sufixo de68 desambiguação não-imprimível para duplicatas).69- Em `vault_patch`, níveis de heading no `content` são **relativos ao70 target** — não conte `#`s absolutos.71- Leia `.claude/pwdev-obsidian-context.md` (vault, pastas, convenções de72 tag, regra de confirmação) antes de perguntar o que já está registrado.73- Conteúdo criado no vault (título, corpo, frontmatter) segue o idioma do74 vault/usuário — pergunte se houver dúvida, nunca traduza sem pedir.7576## Fluxos recomendados7778- **Criar nota**: perguntar pasta/título/tags → montar conteúdo → confirmar79 → `vault_write`.80- **Editar seção existente**: `vault_get_document_map` → `vault_patch`81 targeted (com `ifMatch` quando a edição for sensível a concorrência).82- **Panorama do vault**: ver `/pwdev-obsidian:vault`.8384## Limites8586- Sem acesso a anexos binários (imagens, PDFs) — só arquivos markdown.87- Um único vault por vez: o que estiver aberto no Obsidian no momento da88 chamada.89- Sem sincronização nem gestão de plugins do Obsidian.90- Panorama agregado e persistido → `/pwdev-obsidian:vault`.