Claude Code is powerful, but it forgets everything between sessions. Your coding preferences, project context, architectural decisions—gone every time you start a new conversation. The Smara MCP server fixes this. Install it once, and Claude Code remembers.
After setup, Claude Code will:
Sign up at smara.io (free tier: 100 memories, no credit card).
// ~/.claude/settings.json
{
"mcpServers": {
"smara": {
"command": "npx",
"args": ["-y", "smara-mcp"],
"env": {
"SMARA_API_KEY": "smara_your_key_here",
"SMARA_USER_ID": "your-name"
}
}
}
}
Close and reopen Claude Code. That's it.
The MCP server exposes three tools to Claude Code:
{ "fact": "Sri prefers TypeScript with strict mode", "importance": 0.8 }
{ "q": "TypeScript preferences" }
{ "q": "current project setup", "top_n": 5 }
You: This project uses Fastify with TypeScript, Postgres with pgvector, and we deploy to Railway. Our API prefix is /v1/.
Claude Code: Got it! I'll remember your stack details.
[Internally calls smara_store for each fact]
You: Add a new endpoint for user notifications.
[Searches Smara for project context]
Claude Code: I'll create a Fastify route at /v1/notifications following your existing patterns. Here's the implementation using your Postgres connection pool...
Organize memories by project so they don't bleed between codebases:
{
"mcpServers": {
"smara": {
"command": "npx",
"args": ["-y", "smara-mcp"],
"env": {
"SMARA_API_KEY": "smara_your_key_here",
"SMARA_USER_ID": "sri",
"SMARA_NAMESPACE": "my-api-project"
}
}
}
}
| CLAUDE.md | Smara MCP | |
|---|---|---|
| Scope | Per-project | Cross-project + per-project |
| Updates | Manual edits | Automatic from conversations |
| Search | Full file loaded | Semantic, only relevant facts |
| Decay | No | Yes — stale facts fade |
| Personalization | Project only | You + project |
The best setup is both: CLAUDE.md for static project docs, Smara MCP for dynamic personal and project memory.
| Plan | Memories | Price |
|---|---|---|
| Free | 100 | $0/mo |
| Developer | 10,000 | $19/mo |
| Team | 100,000 | $79/mo |
MCP server not loading? Check that npx is in your PATH and your API key is valid:
curl -H "Authorization: Bearer smara_your_key" https://api.smara.io/health
Want to see what's stored?
curl -H "Authorization: Bearer smara_your_key" \
"https://api.smara.io/v1/memories?user_id=your-name"
Free, no credit card, 30 seconds to persistent memory in Claude Code.
Get Started Free →