Obsidian MCP Server & CLI (WSL to Windows)

Servidor MCP (Model Context Protocol) e ferramenta de linha de comando (CLI) para integrar o Obsidian rodando no Windows com agentes de IA (Antigravity, Claude Desktop, Cursor, Cline) e terminais rodando no WSL2 ou Linux.

🚀 Funcionalidades

• Detecção automática de IP do Windows: Resolve dinamicamente o IP do host Windows a partir do WSL2 (ip route default / /etc/resolv.conf).

• Suporte a HTTPS autoassinado: Aceita os certificados SSL padrão gerados pelo plugin Local REST API do Obsidian.

• Protocolo MCP nativo (stdio): Compatível com Google Antigravity, Claude Desktop, Cursor e qualquer cliente MCP.

• CLI integrada: Permite interagir com o Obsidian diretamente pelo terminal bash no WSL.

Ferramentas MCP Disponíveis

Related MCP server: Obsidian MCP Server

📋 Pré-requisitos

1. Obsidian instalado no Windows com o plugin comunitário Local REST API instalado e ativado.

2. Copie a chave de API gerada nas configurações do plugin Local REST API no Obsidian.

3. Node.js (v18+) e npm instalados no ambiente WSL2 / Linux.

⚙️ Instalação e Configuração

1. Clone o repositório:

git clone https://github.com/artgustavobarros/obsidian-mcp.git
cd obsidian-mcp

2. Instale as dependências:

npm install

3. Configure o arquivo de ambiente:

cp .env.example .env

Edite o arquivo .env:

OBSIDIAN_API_KEY=sua_chave_de_api_aqui
OBSIDIAN_PORT=27124
OBSIDIAN_PROTOCOL=https
# Deixe OBSIDIAN_HOST vazio para detecção automática do IP do Windows no WSL2:
OBSIDIAN_HOST=

4. Compile o projeto TypeScript:

npm run build

🛠️ Configuração nos Clientes MCP

Antigravity (~/.gemini/antigravity-cli/mcp_config.json)

{
  "mcpServers": {
    "obsidian": {
      "command": "node",
      "args": ["/caminho/absoluto/para/obsidian-mcp/dist/index.js"],
      "env": {
        "OBSIDIAN_API_KEY": "sua_chave_aqui"
      }
    }
  }
}

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "obsidian": {
      "command": "node",
      "args": ["/caminho/absoluto/para/obsidian-mcp/dist/index.js"]
    }
  }
}

💻 Uso via Linha de Comando (CLI)

Você pode interagir diretamente com o Obsidian a partir do terminal:

# Verificar status da conexão
node dist/cli.js status

# Ver qual nota está aberta no momento
node dist/cli.js active

# Ler uma nota
node dist/cli.js read "Minhas Anotações.md"

# Abrir uma nota no Obsidian no Windows
node dist/cli.js open "01 - Sessões/Sessão 01.md"

# Buscar notas
node dist/cli.js search "projeto"

# Adicionar conteúdo a uma nota
node dist/cli.js append "Diário/2026-10-16.md" "Reunião finalizada com sucesso."

# Listar tags
node dist/cli.js tags

# Executar comando da paleta
node dist/cli.js cmd "app:open-vault"

Opcionalmente, vincule o CLI globalmente no WSL:

npm link
# Agora você pode usar diretamente:
obsidian status
obsidian active

📄 Licença

Distribuído sob a licença MIT.