User-owned agent memory to save, search, recall and manage scoped memories across AI tools.
Setup
Choose your client, copy the config, then fill in any required environment variables.
Local
claude mcp add xmemo --env XMEMO_KEY='<XMEMO_KEY>' -- npx -y @xmemo/client~/.codex/config.toml
[mcp_servers.xmemo]
command = "npx"
args = ["-y", "@xmemo/client"]
env = { XMEMO_KEY = "<XMEMO_KEY>" }
# codex mcp add xmemo --env XMEMO_KEY='<XMEMO_KEY>' -- npx -y @xmemo/client~/.cursor/mcp.json
{
"mcpServers": {
"xmemo": {
"command": "npx",
"args": [
"-y",
"@xmemo/client"
],
"env": {
"XMEMO_KEY": "<XMEMO_KEY>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"xmemo": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@xmemo/client"
],
"env": {
"XMEMO_KEY": "<XMEMO_KEY>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"xmemo": {
"command": "npx",
"args": [
"-y",
"@xmemo/client"
],
"env": {
"XMEMO_KEY": "<XMEMO_KEY>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"xmemo": {
"command": "npx",
"args": [
"-y",
"@xmemo/client"
],
"env": {
"XMEMO_KEY": "<XMEMO_KEY>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"xmemo": {
"command": "npx",
"args": [
"-y",
"@xmemo/client"
],
"env": {
"XMEMO_KEY": "<XMEMO_KEY>"
}
}
}
}Remote
claude mcp add --transport http xmemo https://xmemo.dev/mcp --header 'Authorization: <AUTHORIZATION>'~/.codex/config.toml
[mcp_servers.xmemo]
url = "https://xmemo.dev/mcp"
http_headers = { Authorization = "<AUTHORIZATION>" }
# codex mcp add xmemo --url https://xmemo.dev/mcp~/.cursor/mcp.json
{
"mcpServers": {
"xmemo": {
"url": "https://xmemo.dev/mcp",
"headers": {
"Authorization": "<AUTHORIZATION>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"xmemo": {
"type": "http",
"url": "https://xmemo.dev/mcp",
"headers": {
"Authorization": "<AUTHORIZATION>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"xmemo": {
"httpUrl": "https://xmemo.dev/mcp",
"headers": {
"Authorization": "<AUTHORIZATION>"
}
}
}
}claude_desktop_config.json · Customize › Connectors › Add custom connector
{
"mcpServers": {
"xmemo": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://xmemo.dev/mcp",
"--header",
"Authorization:<AUTHORIZATION>"
]
}
}
}.trae/mcp.json
{
"mcpServers": {
"xmemo": {
"url": "https://xmemo.dev/mcp",
"headers": {
"Authorization": "<AUTHORIZATION>"
}
}
}
}Environment variables
XMEMO_KEY
Replace the placeholders with your own credentials and keep them out of version control.