Sigil reaches AI apps through one small connector that speaks MCP, the Model Context Protocol. Each app gets its own key and only the folders you tick. Pick your app below.
Before any app: two things, once
01
Make an app key in your vault
Open your vault, go to Apps, choose Connect an app, name it and tick the folders it may read. The app key is shown once; copy it. Each app gets its own key, so you can revoke one without touching the others.
An app key, shown once
sigil_app.<app id>.<secret>
02
Have the connector on your computer
Nothing to install: your AI app starts it with npx -y sigil-connector. It needs Node.js 20 or newer.
01 / 07
Claude Desktop
Starts the connector itselfIn the vault: Claude Desktop
In Claude Desktop open Settings, Developer, Edit Config.
That opens claude_desktop_config.json. On macOS it lives in ~/Library/Application Support/Claude, on Windows in %APPDATA%\Claude.
Add Sigil under mcpServers, next to any servers already there, and save.
Sigil appears in the tools menu of a new chat. Claude asks before it uses a tool for the first time.
02 / 07
Claude Code
Starts the connector itselfIn the vault: Other
Run the command below once in a terminal. It adds Sigil for every project of yours.
To share it with one project only, put the same mcpServers block as for Claude Desktop in a file called .mcp.json in the project folder instead. Keep that file out of version control: it holds your app key.
Start Claude Code and type /mcp to see that sigil is connected.
Terminal
claude mcp add sigil --scope user \
--env SIGIL_APP_KEY=sigil_app.<app id>.<secret> \
--env SIGIL_URL=https://sigilvault.fun \
-- npx -y sigil-connector
Claude Code can now search and read the folders you shared, in any session.
03 / 07
Cursor
Starts the connector itselfIn the vault: Cursor
For every project, open or create ~/.cursor/mcp.json. For one project only, use .cursor/mcp.json in the project folder.
Add Sigil under mcpServers and save.
Open Cursor Settings, MCP, and check that sigil shows as enabled.
Keep the file out of version control, or move the key to an input variable: it holds your app key.
06 / 07
ChatGPT
Connects to an address you runIn the vault: ChatGPT
ChatGPT reaches MCP servers over the internet, so the connector runs in HTTP mode on your computer. Start it with a long random token of your own.
It listens on http://127.0.0.1:8787/mcp/<token>. Expose that port with an HTTPS tunnel service of your choice.
In ChatGPT, turn on developer mode for connectors and add a custom connector with the tunnel address ending in /mcp/<token>, with no authentication. Which plans offer custom connectors is up to ChatGPT.
Keep the address private. The token in the path is what keeps others out. Stop the connector, or revoke the app key, whenever access should end.
Terminal
SIGIL_APP_KEY=sigil_app.<app id>.<secret> \
SIGIL_URL=https://sigilvault.fun \
SIGIL_HTTP_TOKEN=<a long random string> \
npx -y sigil-connector --http --port 8787
Text that ChatGPT reads is processed on its servers under its own terms.
07 / 07
Any MCP client
Stdio or HTTPIn the vault: Other
Any app that can start a local MCP server over stdio uses the command below with the two environment variables.
Apps that only take a URL use HTTP mode, as described for ChatGPT.
The connector offers four tools that read (get_profile, list_folders, search_memories and read_memory) and propose_memory, which suggests a memory to your inbox when you allow it.