Personal Memory
Memco Personal Memory stores your individual preferences, working style, and context in a single place that every AI agent you use can access. Switch between Claude, ChatGPT, Cursor, or any other MCP-compatible client and your agents already know how you work.
Personal memory is private to you. No one else in your organisation can see it, and it is stored separately from your team’s shared memory.
How it relates to Shared Memory
Memco offers two complementary memory products:
- Shared Memory holds what your team should know: validated solutions, operational decisions, institutional knowledge. It is the core Memco product, with trust scoring, multi-agent learning, and governed curation. Learn more about Shared Memory.
- Personal Memory holds what is yours: how you like responses formatted, your editor setup, your role, your working context.
Both are accessed via MCP and managed through the same Memco dashboard at memco.ai . You can use one or both.
Endpoint
https://spark.memco.ai/mcp-personalThis is separate from the Shared Memory endpoint (https://spark.memco.ai/mcp). Each agent connection needs to be configured for the endpoint it will use. An agent can connect to both.
Authentication
Personal Memory uses OAuth 2.0 for authentication, the same flow as Shared Memory. When an MCP client connects for the first time, it redirects you to sign in and authorise the connection. Subsequent connections reuse the stored credentials.
For programmatic access, API keys are available through the Memco dashboard.
Getting started
Coding agents: install the plugin
In Claude Code, Codex and Cursor the fastest route is the personal-memory@memco plugin from the Memco marketplace. It registers the Personal Memory MCP server and installs the agent instructions in one step.
/plugin marketplace add memcoai/marketplace
/plugin install personal-memory@memcocodex plugin marketplace add memcoai/marketplace
codex plugin add personal-memory@memcoIn Cursor, add memcoai/marketplace under Settings → Plugins → Team Marketplaces and install memco-personal-memory from the marketplace panel.
If you also use Shared Memory, install shared-memory@memco alongside it. The two plugins connect to different servers and do not interfere with each other.
Assistants: connect the server
Step 1: Add the MCP server
Add the Memco Personal Memory MCP server through your assistant’s MCP or integrations settings.
Claude and Claude Desktop — go to Settings → Connectors and add the Memco Personal Memory connector from the directory, or add it as a custom connector with the endpoint above.
Claude Desktop, manual configuration — add the following to your claude_desktop_config.json:
{
"mcpServers": {
"memco-personal-memory": {
"url": "https://spark.memco.ai/mcp-personal"
}
}
}Cursor — add to your MCP settings in .cursor/mcp.json:
{
"mcpServers": {
"memco-personal-memory": {
"url": "https://spark.memco.ai/mcp-personal"
}
}
}Claude Code — add from the command line:
claude mcp add memco-personal-memory --transport streamable-http https://spark.memco.ai/mcp-personalStep 2: Instruct your agent to use it
Adding the MCP server makes the tools available, but your agent also needs to know it should use them. Add the following to your project instructions, custom instructions, or system prompt:
You have access to a personal memory server through the Memco Personal
Memory MCP server. Use that to store and recall my preferences, working
style, and personal context across sessions.Where to put this depends on your assistant:
- Claude — add to your project instructions, or to Settings → Profile → User preferences for it to apply across all conversations
- ChatGPT — add to Personalisation → Custom Instructions
- Cursor — add to your project-level rules or
.cursorrulesfile
Step 3: Verify the connection
Ask your agent:
“What do you know about my preferences?”
If the connection is working, the agent will call start_session and report back what it finds. On a fresh account, it will say there are no saved preferences yet.
Tool surface
Memco Personal Memory provides seven MCP tools:
| Tool | Purpose |
|---|---|
start_session | Load your preferences and tag overview at the start of a conversation |
search | Find memories by semantic query |
list_memories | Browse all memories, with optional keyword and tag filters |
get_memory | Fetch the full content of a memory by its ID |
write_memory | Save a new memory |
update_memory | Edit part of an existing memory in place |
delete_memory | Permanently remove a memory |
See the Tools Reference for the complete specification of each tool.
How agents use the tools
A typical session:
-
Start. The agent calls
start_sessionat the beginning of a conversation. This returns a summary of your stored preferences (memories taggedtype:user) and the tags in use, giving the agent immediate context about how you work. -
Recall. When the agent needs to check a preference or piece of context, it calls
searchwith a query, orlist_memoriesto browse. -
Learn. When you share a new preference or the agent discovers one through the conversation, it calls
write_memoryto save it. -
Update. When a preference changes, the agent calls
update_memoryto edit it in place rather than creating a duplicate. -
Forget. When you ask the agent to forget something, it calls
delete_memory. Deletion is permanent.
Managing your memories
All your personal memories are visible and editable through the Memco dashboard at memco.ai . You can view, edit, and delete individual memories at any time. The dashboard gives you full control over what your agents remember about you.