Basic Memory

Server MCP di Basic Machines

Keep persistent AI memory as a local Markdown knowledge graph that you and your assistant both read and edit.

Gira in locale (Gira sul tuo computer: la sua pagina riporta il comando di installazione)Gira con uvx

Installa Basic Memory

Gira sul tuo computer. Il tuo client lo avvia con questo comando:

uvx --prerelease=allow basic-memory mcp

Richiede uv (Python) sul tuo computer. I passaggi qui sotto mostrano dove va il comando in ogni client.

Condividi questo server

Apre questa pagina, con il comando di installazione e i passaggi di configurazione.

mcp.tc/i/basic-memory

Descrizione

Basic Memory stores what you and your AI talk about as plain Markdown files on your disk. Notes use observations and wikilinks to form a knowledge graph. Both you and the assistant can write to the same files, and sync keeps them aligned. It also offers semantic search and works with Obsidian, since it reads and writes the same Markdown.

It runs locally over stdio as a Python package started with uvx, and needs no sign-in or API key. The --prerelease=allow flag is required because of a pre-release FastMCP dependency. A hosted Basic Memory Cloud option exists at https://cloud.basicmemory.com/mcp with OAuth sign-in and a paid plan.

Cosa puoi fare

  • Store AI conversation context as local Markdown notes
  • Build a knowledge graph from observations and wikilinks
  • Search notes by keyword or by meaning with semantic search
  • Edit the same files by hand or through the assistant
  • Work with Obsidian and other MCP clients
  • Optionally use the hosted cloud version for cross-device sync

Tool

I server locali mostrano i loro tool solo quando sono in esecuzione, e questo non pubblica l’elenco in anticipo. Il tuo client li mostra dopo averlo aggiunto.

Prompt di esempio

  • Save a note summarizing our decisions about the API design.

  • What did we decide last week about the database schema?

  • Search my notes for anything related to authentication.

  • Continue from where we left off on the migration project.

Configurazione

Ogni client avvia Basic Memory sul tuo computer con lo stesso comando. Scegli il tuo; la pagina ricorda la tua scelta.

Claude Code

  1. Eseguilo in un terminale, nella cartella del tuo progetto:
claude mcp add --transport stdio basic-memory -- uvx --prerelease=allow basic-memory mcp
  1. Avvia Claude Code e digita /mcp. basic-memory dovrebbe risultare collegato.

Aggiungi --scope user per renderlo disponibile in tutti i progetti.

Claude Desktop

  1. Apri Settings → Developer → Edit Config. Si apre claude_desktop_config.json. Aggiungi:
claude_desktop_config.json
{
  "mcpServers": {
    "basic-memory": {
      "command": "uvx",
      "args": [
        "--prerelease=allow",
        "basic-memory",
        "mcp"
      ]
    }
  }
}
  1. Salva il file e riavvia Claude Desktop.

Richiede uv (Python) sul tuo computer. Il file si trova in ~/Library/Application Support/Claude/ su macOS e in %APPDATA%\Claude\ su Windows.

Cursor

Oppure aggiungilo a mano in ~/.cursor/mcp.json (tutti i progetti) o in .cursor/mcp.json (questo progetto):

mcp.json
{
  "mcpServers": {
    "basic-memory": {
      "command": "uvx",
      "args": [
        "--prerelease=allow",
        "basic-memory",
        "mcp"
      ]
    }
  }
}

Richiede uv (Python) sul tuo computer.

VS Code

Oppure da un terminale:

code --add-mcp '{"name":"basic-memory","type":"stdio","command":"uvx","args":["--prerelease=allow","basic-memory","mcp"]}'

Oppure fai commit nel repository in .vscode/mcp.json:

.vscode/mcp.json
{
  "servers": {
    "basic-memory": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "--prerelease=allow",
        "basic-memory",
        "mcp"
      ]
    }
  }
}

Richiede uv (Python) sul tuo computer.

Devin Desktop

  1. Aggiungilo a ~/.config/devin/mcp_config.json (macOS e Linux) o a %APPDATA%\devin\mcp_config.json (Windows):
mcp_config.json
{
  "mcpServers": {
    "basic-memory": {
      "command": "uvx",
      "args": [
        "--prerelease=allow",
        "basic-memory",
        "mcp"
      ]
    }
  }
}
  1. Aggiorna l’elenco dei server MCP in Cascade.

Devin Desktop è il nuovo nome di Windsurf.

Codex

codex mcp add basic-memory -- uvx --prerelease=allow basic-memory mcp

Oppure modifica direttamente ~/.codex/config.toml:

config.toml
[mcp_servers.basic-memory]
command = "uvx"
args = ["--prerelease=allow", "basic-memory", "mcp"]

Richiede uv (Python) sul tuo computer.

Gemini CLI

gemini mcp add basic-memory uvx -- --prerelease=allow basic-memory mcp

Così 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": {
    "basic-memory": {
      "command": "uvx",
      "args": [
        "--prerelease=allow",
        "basic-memory",
        "mcp"
      ]
    }
  }
}

Zed mette i server sotto context_servers nelle sue impostazioni, con gli stessi campi command, args ed env.

Richiede uv (Python) sul tuo computer.

Domande frequenti

Posso incollare mcp.tc/i/basic-memory nel mio client MCP?

No. Basic Memory 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 --prerelease=allow basic-memory mcp.

Basic Memory richiede una chiave API?

No. Non dichiara chiavi né variabili d’ambiente. Gira con i permessi del tuo account utente, quindi controlla cosa possono raggiungere i suoi tool.

Basic Memory è un server remoto o locale?

Locale. Il tuo client lo avvia come processo sul tuo computer con uvx --prerelease=allow basic-memory mcp, che richiede uv (Python).

Cosa può fare Basic Memory?

Puoi store AI conversation context as local Markdown notes, build a knowledge graph from observations and wikilinks e search notes by keyword or by meaning with semantic search.

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.

Chi ha scritto questa pagina?

Il robot di mcp.tc ha letto i metadati pubblici di Basic Memory (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.

Embed

Mostra Basic Memory 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

Badge per il README

Anteprima del badge, chiaroAnteprima del badge, scuro
Markdown
[![Basic Memory on mcp.tc](https://mcp.tc/i/basic-memory/badge.svg)](https://mcp.tc/i/basic-memory)
HTML
<a href="https://mcp.tc/i/basic-memory"><img src="https://mcp.tc/i/basic-memory/badge.svg" alt="Basic Memory 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.

Scheda per il sito

HTML
<script src="https://mcp.tc/w/basic-memory.js" async></script>

La scheda 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

HTML
<iframe src="https://mcp.tc/embed/basic-memory" title="Basic Memory 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 «Aggiungi a». Qualsiasi sito può leggerla (CORS aperto).

https://mcp.tc/i/basic-memory.json

Cosa significa ogni campo

mcp.tc non è affiliato a Basic Machines. Questa pagina è stata costruita dai metadati pubblici di Basic Memory (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.