Memstate + ChatGPT
Give ChatGPT Desktop persistent, structured memory via MCP.
ChatGPT's built-in memory is limited to personal facts and preferences. Memstate gives ChatGPT Desktop a full structured memory layer via MCP — with versioned keypaths, semantic search, and project-scoped context that persists across every conversation.
Get Your API Key
Sign up for free — no credit card required.
Sign Up FreeAlready have an account? Go to API Keys →
Add MCP Configuration
Add this to your ChatGPT MCP config file. Replace YOUR_API_KEY_HERE with your key.
{
"mcpServers": {
"memstate": {
"command": "npx",
"args": ["-y", "@memstate/mcp"],
"env": {
"MEMSTATE_API_KEY": "YOUR_API_KEY_HERE"
}
}
}
}Save to:
~/Library/Application Support/ChatGPT/claude_desktop_config.jsonChatGPT Desktop MCP support
MCP is supported in ChatGPT Desktop (macOS and Windows). The MCP config file path is:
- macOS:
~/Library/Application Support/ChatGPT/claude_desktop_config.json - Windows:
%APPDATA%\ChatGPT\claude_desktop_config.json
After saving the config, restart ChatGPT Desktop. The Memstate tools will appear in the tool picker.
ChatGPT.com (browser) does not support MCP
MCP is only available in the ChatGPT Desktop app. The web version at chatgpt.com does not support MCP servers.
Add Agent Rule
This rule tells ChatGPT to load your project context before tasks and save summaries after — automatically, every session.
# Memstate MCP - Memory Storage
This project uses Memstate MCP for persistent, versioned memory across sessions.
## REQUIRED: Start and end every task with memory
**BEFORE starting any task**, load existing context so you don't redo past work or revert intentional decisions:
```
memstate_get(project_id="<your_project>")
```
**AFTER completing any task**, save what you did so the next session has context:
```
memstate_remember(project_id="<your_project>", content="## Task Summary\n- What was done\n- Key decisions made\n- Files modified", source="agent")
```
These two calls are mandatory. Skipping them means the next session starts blind.
## Tool reference
| Tool | When to use |
|------|-------------|
| memstate_get | **Start of every task.** Browse project tree or fetch content at a keypath. |
| memstate_remember | **End of every task.** Save markdown summaries, notes, decisions. |
| memstate_search | Find memories by meaning when you don't know the exact keypath. |
| memstate_set | Store a single key=value fact (e.g. config.port). Not for summaries. |
| memstate_history | View version history of a keypath. |
| memstate_delete | Soft-delete a keypath (history preserved). |
## Project naming
Use a short snake_case name matching your repo or topic (e.g. my_app, api_service). All related memories should share the same project_id.Paste into Custom Instructions or AGENTS.md at your project root.
Test It — Onboard Your Project
Restart ChatGPT, open a project, and paste this prompt. It will create your first memories and confirm everything is working.
Replace <your_project> with a short name for your repo (e.g. my_app).
I'm onboarding Memstate AI memory for this project. Please:
1. Analyze this codebase and write a concise high-level architecture overview in markdown — covering the main components, tech stack, key directories, and how data flows through the system.
2. Save it to Memstate using: memstate_remember(project_id="<your_project>", content="<the markdown>", source="agent")
3. Then call memstate_get(project_id="<your_project>") and show me the memory tree so I can confirm it worked.What to expect
Your agent will analyze the codebase, write an architecture overview, save it to Memstate, then display the memory tree. You'll see structured memories like project.my_app.architecture — this context is now available in every future session automatically.
Related Resources
Mem0 vs Memstate
See how Memstate compares to Mem0 on the LoCoMo benchmark. Memstate scores 5.3x higher on fact recall accuracy (92.2% vs 17.5%) and 4.7x better on conflict detection (95.0% vs 20.2%).
What is AI Agent Memory?
Learn how structured, versioned memory differs from traditional RAG and vector search.