What is SAME and how does it work with AI agents?

SAME is an MCP server that provides persistent memory for AI coding agents using local SQLite and vector search. It stores code context, decisions, and project state in a markdown notes directory (VAULT_PATH), allowing agents to retrieve relevant information across sessions without cloud dependencies.

How do I set up SAME?

Install via `npx @sgx-labs/same@0.12.1` and set the required VAULT_PATH environment variable to point to your markdown notes directory. The server uses stdio transport and exposes 17 MCP tools for memory operations.

Is SAME cloud-based or local?

SAME is local-first and runs entirely on your machine using SQLite. Your vault data stays in the VAULT_PATH directory you control, with no external service required.

Can I use SAME with existing note systems?

Yes—SAME stores memories as markdown files in your specified VAULT_PATH directory, making it compatible with existing markdown-based note systems and version control.

What happens if I don't set VAULT_PATH?

VAULT_PATH is required; the server will not start without it. Point it to an existing or new directory where you want markdown notes and SQLite indexes stored.

MCP ServerSTDIOOfficialv0.12.1

SAME - Stateless Agent Memory Engine MCP Server

Build persistent memory for AI coding agents with local-first SQLite and vector search. Store and retrieve code context, decisions, and project state across agent sessions without external dependencies.

io.github.sgx-labs/same

Try MCP with AI models View source

Hosted URL

Local install

Transport

STDIO

Auth

1 required env var

What the SAME - Stateless Agent Memory Engine MCP server does

How models use it and what it is built for.

Connect to SAME - Stateless Agent Memory Engine

Local install — runs as a subprocess.

npx @sgx-labs/same@0.12.1

Environment variables

Configuration this server reads at startup.

VAULT_PATHRequired
Path to your markdown notes directory

Resources

Where to find authoritative docs and source for SAME - Stateless Agent Memory Engine.

Example prompts for SAME - Stateless Agent Memory Engine

Paste any of these into Agent Studio after connecting SAME - Stateless Agent Memory Engine.

Store this function signature and its purpose in my vault for future reference
Search my vault for previous solutions to authentication middleware problems
Create a memory entry linking this API schema to our database migration strategy
What coding patterns have I documented in my vault that match this use case?