Servidor MCP Obsidian

Buscar, ler e editar notas de um cofre do Obsidian.

ComunidadeLocal · uvxmantido por Markus Pfundstein

O que é

Servidor da comunidade que conversa com o Obsidian pelo plugin Local REST API. O Obsidian precisa estar aberto, com o plugin instalado e ativo.

Exemplos de pedidos

“Encontre minhas notas sobre a reunião de planejamento e resuma as decisões.”

Antes de instalar

Requer uv (uvx) e o plugin comunitário Local REST API. Host e porta padrão do plugin podem ser ajustados com OBSIDIAN_HOST e OBSIDIAN_PORT.

Sinais de confiança

Quem mantém: Comunidade Markus PfundsteinMantido por terceiros. O dono do serviço não responde por este código: leia o repositório antes de instalar.
Repositório: MarkusPfundstein/mcp-obsidian
Licença: MIT
Último commit: 31/08/2026 (36 dias antes da coleta)
Estrelas: 4,5 mil
Registro oficial: Entrada não conferida por nós no registro oficial
Transporte: Local (stdio), iniciado com uvx
O que você preenche: OBSIDIAN_API_KEY — Chave do plugin Local REST APIcredencial
Configuração conferida: 03/10/2026, no README do repositório

Estrelas, licença e último commit: API do GitHub, retrato incluído nesta versão do site, coletado em 07/10/2026. Situação no registro: registry.modelcontextprotocol.io, na mesma data.

Configurar o Obsidian em cada cliente

Sem token nesta página. O que está destacado você preenche na sua máquina. Para combinar com outros servidores ou gerar a versão para Windows, use o gerador com o Obsidian já marcado.

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

{
  "mcpServers": {
    "obsidian": {
      "command": "uvx",
      "args": [
        "mcp-obsidian"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "<OBSIDIAN_API_KEY>"
      }
    }
  }
}

OBSIDIAN_API_KEY: Substitua <OBSIDIAN_API_KEY> pelo valor, direto no arquivo, na sua máquina. É uma credencial: não versione nem compartilhe o arquivo depois de preenchido.

Onde fica o arquivo e como conferir no Claude Desktop

ComandosTerminal, na pasta do projeto

claude mcp add --transport stdio --env "OBSIDIAN_API_KEY=<OBSIDIAN_API_KEY>" obsidian -- uvx mcp-obsidian

OBSIDIAN_API_KEY: Substitua <OBSIDIAN_API_KEY> pelo valor, direto no comando, na sua máquina. É uma credencial: não versione nem compartilhe o arquivo depois de preenchido.

Onde fica o arquivo e como conferir no Claude Code

mcp.json.cursor/mcp.json

{
  "mcpServers": {
    "obsidian": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mcp-obsidian"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "${env:OBSIDIAN_API_KEY}"
      }
    }
  }
}

OBSIDIAN_API_KEY: Defina a variável de ambiente OBSIDIAN_API_KEY no sistema. O arquivo guarda só a referência ${env:OBSIDIAN_API_KEY}.

Onde fica o arquivo e como conferir no Cursor

mcp.json.vscode/mcp.json

{
  "inputs": [
    {
      "type": "promptString",
      "id": "obsidian-api-key",
      "description": "Chave do plugin Local REST API",
      "password": true
    }
  ],
  "servers": {
    "obsidian": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mcp-obsidian"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "${input:obsidian-api-key}"
      }
    }
  }
}

OBSIDIAN_API_KEY: O VS Code pede este valor em uma caixa de senha na primeira vez que o servidor inicia.

Onde fica o arquivo e como conferir no VS Code

mcp_config.json~/.config/devin/mcp_config.json

{
  "mcpServers": {
    "obsidian": {
      "command": "uvx",
      "args": [
        "mcp-obsidian"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "${env:OBSIDIAN_API_KEY}"
      }
    }
  }
}

OBSIDIAN_API_KEY: Defina a variável de ambiente OBSIDIAN_API_KEY no sistema. O arquivo guarda só a referência ${env:OBSIDIAN_API_KEY}.

Onde fica o arquivo e como conferir no Windsurf

O que ele alcança

Todas as notas do cofre aberto no Obsidian, para leitura e edição.

Riscos e como reduzir

O assistente pode alterar e apagar notas. Faça backup ou versionamento do cofre antes.
Mantido por uma pessoa, não pela Obsidian.

Contexto geral em Segurança no MCP. Código-fonte: github.com/MarkusPfundstein/mcp-obsidian.

Outros servidores de arquivos e sistema

Perguntas frequentes

O servidor Obsidian é oficial?

Comunidade: é mantido por Markus Pfundstein, no repositório MarkusPfundstein/mcp-obsidian. Mantido por terceiros. O dono do serviço não responde por este código: leia o repositório antes de instalar.

Que credenciais o Obsidian pede?

OBSIDIAN_API_KEY (chave do plugin local rest api). O gerador deste site não recebe esse valor: ele entra na sua máquina, no lugar do marcador.

Como o Obsidian é executado?

É um servidor local, iniciado com uvx (exige uv). O cliente inicia o processo sozinho quando abre.

O Obsidian funciona no Cursor, no VS Code e no Claude Code?

Sim. Esta página traz o bloco de configuração para Claude Desktop, Claude Code, Cursor, VS Code e Windsurf, cada um no formato do cliente.

Quando esta configuração foi conferida?

Em 03/10/2026, no README do repositório MarkusPfundstein/mcp-obsidian. Se o comando mudar depois disso, vale o que o repositório publicar.