Obsidian
Server MCP di Markus Pfundstein
Leggi, cerca e modifica le note in un vault di Obsidian tramite il plugin Local REST API.
Installa Obsidian
Gira sul tuo computer. Il tuo client lo avvia con questo comando:
Richiede uv (Python) sul tuo computer. I passaggi qui sotto mostrano dove va il comando in ogni client.
OBSIDIAN_API_KEYsegreto API key of the Obsidian Local REST API plugin.
Condividi questo server
Apre questa pagina, con il comando di installazione e i passaggi di configurazione.
mcp.tc/i/obsidianDescrizione
Collega un assistente a un vault di Obsidian tramite il plugin della community Obsidian Local REST API. Può elencare file e cartelle, leggere il contenuto delle note, cercare in tutto il vault, aggiungere o applicare patch al contenuto delle note ed eliminare file.
Funziona in locale tramite stdio con uvx mcp-obsidian e richiede Python 3.11 o successivo. Il plugin Local REST API deve essere installato e abilitato in Obsidian, e il server richiede la chiave API del plugin in OBSIDIAN_API_KEY. Host e porta sono facoltativi e di default sono 127.0.0.1 e 27124.
Cosa puoi fare
- Elencare file e directory del vault
- Leggere il contenuto di una nota
- Cercare testo in tutti i file del vault
- Aggiungere contenuto a note nuove o esistenti
- Inserire contenuto rispetto a un titolo, un blocco o un campo frontmatter
- Eliminare file o directory dal vault
Tool
Obsidian mostra i suoi tool solo ai client con una chiave, quindi non possiamo elencarli qui.
Prompt di esempio
Recupera il contenuto della mia ultima nota sulla call di architettura e riassumilo
Cerca nel mio vault le note che menzionano Azure CosmosDB
Riassumi le ultime note della riunione in una nuova nota chiamata summary meeting.md
Aggiungi una lista di cose da fare alla nota del piano del mio progetto
Configurazione
Ogni client avvia Obsidian sul tuo computer con lo stesso comando. Scegli il tuo; la pagina ricorda la tua scelta.
Claude Code
- Eseguilo in un terminale, nella cartella del tuo progetto:
claude mcp add --transport stdio obsidian --env "OBSIDIAN_API_KEY=<YOUR_OBSIDIAN_API_KEY>" -- uvx mcp-obsidian- Avvia Claude Code e digita
/mcp. obsidian dovrebbe risultare collegato.
Aggiungi --scope user per renderlo disponibile in tutti i progetti. Sostituisci i segnaposto con i tuoi valori.
Claude Desktop
- Apri Settings → Developer → Edit Config. Si apre
claude_desktop_config.json. Aggiungi:
{
"mcpServers": {
"obsidian": {
"command": "uvx",
"args": [
"mcp-obsidian"
],
"env": {
"OBSIDIAN_API_KEY": "<YOUR_OBSIDIAN_API_KEY>"
}
}
}
}- Salva il file e riavvia Claude Desktop. Sostituisci i segnaposto con i tuoi valori.
Richiede uv (Python) sul tuo computer. Il file si trova in ~/Library/Application Support/Claude/ su macOS e in %APPDATA%\Claude\ su Windows.
Cursor
Aggiungi a Cursor (si apre in una nuova scheda)
Oppure aggiungilo a mano in ~/.cursor/mcp.json (tutti i progetti) o in .cursor/mcp.json (questo progetto):
{
"mcpServers": {
"obsidian": {
"command": "uvx",
"args": [
"mcp-obsidian"
],
"env": {
"OBSIDIAN_API_KEY": "<YOUR_OBSIDIAN_API_KEY>"
}
}
}
}Richiede uv (Python) sul tuo computer. Sostituisci i segnaposto con i tuoi valori.
VS Code
Aggiungilo a .vscode/mcp.json. VS Code chiede il segreto la prima volta e lo conserva in modo sicuro:
{
"servers": {
"obsidian": {
"type": "stdio",
"command": "uvx",
"args": [
"mcp-obsidian"
],
"env": {
"OBSIDIAN_API_KEY": "${input:obsidian-api-key}"
}
}
},
"inputs": [
{
"type": "promptString",
"id": "obsidian-api-key",
"description": "OBSIDIAN_API_KEY",
"password": true
}
]
}Richiede uv (Python) sul tuo computer.
Devin Desktop
- Aggiungilo a
~/.config/devin/mcp_config.json(macOS e Linux) o a%APPDATA%\devin\mcp_config.json(Windows):
{
"mcpServers": {
"obsidian": {
"command": "uvx",
"args": [
"mcp-obsidian"
],
"env": {
"OBSIDIAN_API_KEY": "<YOUR_OBSIDIAN_API_KEY>"
}
}
}
}- Aggiorna l’elenco dei server MCP in Cascade. Sostituisci i segnaposto con i tuoi valori.
Devin Desktop è il nuovo nome di Windsurf.
Codex
codex mcp add obsidian --env "OBSIDIAN_API_KEY=<YOUR_OBSIDIAN_API_KEY>" -- uvx mcp-obsidianOppure modifica direttamente ~/.codex/config.toml:
[mcp_servers.obsidian]
command = "uvx"
args = ["mcp-obsidian"]
env = { OBSIDIAN_API_KEY = "<YOUR_OBSIDIAN_API_KEY>" }Richiede uv (Python) sul tuo computer. Sostituisci i segnaposto con i tuoi valori.
Gemini CLI
gemini mcp add -e "OBSIDIAN_API_KEY=<YOUR_OBSIDIAN_API_KEY>" obsidian uvx mcp-obsidianCosì lo aggiungi al progetto corrente. Aggiungi -s user per usarlo ovunque.
Qualsiasi client
La maggior parte dei client che avviano server locali accetta questa forma:
{
"mcpServers": {
"obsidian": {
"command": "uvx",
"args": [
"mcp-obsidian"
],
"env": {
"OBSIDIAN_API_KEY": "<YOUR_OBSIDIAN_API_KEY>"
}
}
}
}Zed mette i server sotto context_servers nelle sue impostazioni, con gli stessi campi command, args ed env.
Richiede uv (Python) sul tuo computer. Sostituisci i segnaposto con i tuoi valori.
Embed
Mostra Obsidian in un README o sul tuo sito. Ogni embed rimanda a questa pagina, usa il comando di installazione del server e non imposta cookie. Come funzionano gli embed
Card, iframe e JSON sono in inglese. Aggiungi ?lang=it, fr, de o es al loro indirizzo per un’altra lingua.
Badge per il README
[](https://mcp.tc/i/obsidian)<a href="https://mcp.tc/i/obsidian"><img src="https://mcp.tc/i/obsidian/badge.svg" alt="Obsidian on mcp.tc" height="20"></a>Segue la modalità chiara o scura di chi legge. Aggiungi ?theme=light o ?theme=dark per fissarla, oppure ?style=compact per mostrare il simbolo senza la scritta.
Card per il sito
<script src="https://mcp.tc/w/obsidian.js" async></script>La card compare dove si trova il tag. Aggiungi data-theme="dark" o data-size="compact" al tag per cambiarla. Il file contiene tutto ciò che serve, quindi non fa altre richieste e non imposta cookie.
iframe
<iframe src="https://mcp.tc/embed/obsidian" title="Obsidian on mcp.tc" width="420" height="200" loading="lazy" allow="clipboard-write" style="border:0;border-radius:8px;max-width:100%"></iframe>Usalo nelle pagine che non consentono script. Aggiungi ?theme=light o ?theme=dark all’indirizzo per fissare i colori.
JSON
La scheda come dati per le tue pagine e i tuoi strumenti: nome, descrizione breve, comando di installazione, tool e i link «Add to». Qualsiasi sito può leggerla (CORS aperto).
https://mcp.tc/i/obsidian.jsonPrompt per l’AI
Incollalo in un assistente di programmazione con l’AI, come Claude Code o Cursor, e aggiungerà la card di Obsidian al tuo sito.
Aggiungi al mio sito la card di mcp.tc per Obsidian, un server MCP. È un solo script statico: niente build, nessun pacchetto da installare, nessun cookie.
Metti questo tag dove deve comparire la card. La card appare subito prima del tag:
```html
<script src="https://mcp.tc/w/obsidian.js" async></script>
```
Per mostrarla altrove, metti lì questo segnaposto e carica lo stesso script una volta sola, per esempio prima di `</body>`. Lascia il link al suo interno: lo vede chi non ha JavaScript.
```html
<div data-mcptc="obsidian"><a href="https://mcp.tc/i/obsidian">Obsidian on mcp.tc</a></div>
```
Opzioni:
- `data-theme="light"` o `"dark"` sul tag o sul segnaposto fissa i colori. Senza l’attributo, la card segue la modalità chiara o scura di chi visita.
- `data-size="compact"` dà una card più piccola, senza la descrizione breve.
- La variabile CSS `--mcptc-max-width` sul segnaposto o su un elemento padre imposta la larghezza (predefinita `520px`).
- `?lang=` nell’URL dello script imposta la lingua della card: `en`, `it`, `fr`, `de` o `es`.
Se il sito ha una Content Security Policy, consenti `script-src https://mcp.tc` e `img-src data:` (l’icona è inline).
Per un README o altra documentazione in Markdown, usa invece il badge:
```markdown
[](https://mcp.tc/i/obsidian)
```
Riferimento: https://mcp.tc/it/embedCronologia delle modifiche
Questo server gira sul tuo computer, quindi seguiamo il suo pacchetto PyPI: qui compare ogni nuova versione, insieme alle modifiche di chi lo gestisce.
Domande frequenti
Posso incollare mcp.tc/i/obsidian nel mio client MCP?
No. Obsidian gira sul tuo computer, avviato dal tuo client, quindi non ha un indirizzo web a cui collegarsi. Il link rapido è la pagina da condividere; il comando di installazione è uvx mcp-obsidian.
Obsidian richiede una chiave API?
Sì. Legge OBSIDIAN_API_KEY dal suo ambiente, e OBSIDIAN_API_KEY è un segreto. Metti il valore nella configurazione del tuo client sul tuo computer, mai in un file condiviso.
Obsidian è un server remoto o locale?
Locale. Il tuo client lo avvia come processo sul tuo computer con uvx mcp-obsidian, che richiede uv (Python).
Cosa può fare Obsidian?
Puoi elencare file e directory del vault, leggere il contenuto di una nota e cercare testo in tutti i file del vault.
Quali client possono usarlo?
Qualsiasi client che avvia server locali: Claude Code, Claude Desktop, Cursor, VS Code, Devin Desktop, Codex, Gemini CLI, Zed e altri. claude.ai e ChatGPT si collegano solo a server remoti.
mcp.tc tiene traccia delle modifiche di Obsidian?
In parte. Gira sul tuo computer, quindi seguiamo il suo pacchetto PyPI: la sua sezione Cronologia mostra ogni nuova versione e le modifiche di chi lo gestisce. Segui la scheda per ricevere un’email quando cambia.
Chi ha scritto questa pagina?
Il robot di mcp.tc ha letto i metadati pubblici di Obsidian (le pagine del suo pacchetto e del repository), e un modello di AI ne ha ricavato il testo. Una persona esamina tutto ciò che i controlli non riescono a confermare. Il testo può comunque contenere errori, quindi se ne trovi uno usa Segnala questa scheda su questa pagina. Questa traduzione è stata fatta da un modello di AI a partire dal testo inglese.
mcp.tc non è affiliato a Markus Pfundstein. Questa pagina è stata creata a partire dai metadati pubblici di Obsidian (ultimo controllo: 3 ott 2026), e la descrizione l’ha scritta un modello di AI, quindi può contenere errori. Nomi e marchi appartengono ai rispettivi titolari. Qualcosa non va? Segnala questa scheda. La traduzione è stata fatta da un modello di AI a partire dal testo inglese.