io.github.VelixarAi/memory
Persistent memory for AI assistants. Store, search, and recall across sessions.
Ask AI about io.github.VelixarAi/memory
Powered by Claude Β· Grounded in docs
I know everything about io.github.VelixarAi/memory. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
Velixar MCP Server
MCP server that gives any AI assistant persistent memory via Velixar. Works with any Model Context Protocol-compatible client β Claude Desktop, Kiro, Cursor, Windsurf, Continue, or any MCP-enabled tool.
What It Does
Your AI assistant forgets everything between sessions. This server fixes that. It connects to Velixar's memory API and exposes 5 tools that let your assistant store, search, list, update, and delete memories that persist across conversations.
Setup
-
Get an API key at velixarai.com/settings/api-keys
-
Install:
npm install -g velixar-mcp-server
- Add to your MCP client config:
Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"velixar": {
"command": "velixar-mcp-server",
"env": {
"VELIXAR_API_KEY": "vlx_your_key_here"
}
}
}
}
Kiro CLI (~/.kiro/settings/mcp.json):
{
"mcpServers": {
"velixar": {
"command": "velixar-mcp-server",
"env": {
"VELIXAR_API_KEY": "vlx_your_key_here"
}
}
}
}
Cursor (.cursor/mcp.json in your project):
{
"mcpServers": {
"velixar": {
"command": "velixar-mcp-server",
"env": {
"VELIXAR_API_KEY": "vlx_your_key_here"
}
}
}
}
- Restart your AI assistant
Tools
| Tool | Description |
|---|---|
velixar_store | Store a memory with optional tags and tier |
velixar_search | Semantic search across memories |
velixar_list | Browse memories with pagination |
velixar_update | Edit an existing memory |
velixar_delete | Delete a memory by ID |
Memory Tiers
| Tier | Name | Use Case |
|---|---|---|
| 0 | Pinned | Critical facts, never expire |
| 1 | Session | Current conversation context |
| 2 | Semantic | Long-term memories (default) |
| 3 | Organization | Shared team knowledge |
Environment Variables
| Variable | Required | Description |
|---|---|---|
VELIXAR_API_KEY | Yes | Your Velixar API key |
VELIXAR_API_URL | No | Custom API endpoint |
VELIXAR_USER_ID | No | User ID for memory scoping (default: kiro-cli) |
Example
Once configured, your AI assistant can:
You: Remember that our production database is on us-east-1 and staging is us-west-2
Assistant: β Stored memory
You: Which region is our staging database in?
Assistant: Based on my memory, your staging database is in us-west-2.
Memories persist across sessions, restarts, and even different machines β as long as they use the same API key.
Related
- velixar (JavaScript SDK) β Use Velixar directly in Node.js/TypeScript
- velixar (Python SDK) β Python client with LangChain/LlamaIndex integrations
- velixarai.com β Dashboard, API keys, and docs
License
MIT
