How to install telemem in Windsurf

Long-term and multimodal memory for AI agents - character-aware, mem0-compatible, fully-local option

Indexed, not yet reviewed

We found telemem in the official MCP registry. Our automated check passed on Nov 1, 2026 (it confirms the server is published and reachable), but no one at CuratedMCP has reviewed its code, permissions or credentials handling. Check what it can access before you give it keys. Scan your machine free to see every MCP server you have installed.

Steps

1Install uv (for uvx): https://docs.astral.sh/uv/
2Open ~/.codeium/windsurf/mcp_config.json
3Add the entry below. If the file already has "mcpServers", add just the inner entry
4Refresh the MCP servers list in Windsurf's Cascade panel

Configuration

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "telemem": {
      "command": "uvx",
      "args": [
        "telemem"
      ]
    }
  }
}

Environment variable	Required	What it is
OPENAI_API_KEYsecret	No	API key for the default OpenAI LLM/embedder (not needed with a local TELEMEM_CONFIG)
TELEMEM_CONFIG	No	Path to a TeleMem YAML/JSON config, e.g. the fully-local Ollama + FAISS setup (config/config.ollama.yaml)
TELEMEM_DEFAULT_USER_ID	No	Default memory scope when tool calls omit user_id/agent_id/run_id (default: telemem-mcp)

Install in other clients

Claude Code Cursor Claude Desktop Gemini CLI OpenAI Agents SDK

About telemem: repo, license and check results →

Maintain telemem?

Claim this page to get a full CuratedMCP listing: edit your description, see listing analytics, and add our README badge. Listing is free, and a person checks every submission before it goes live. We'll pre-fill the form from the registry.

Claim this listing What maintainers get