
Memory Mcp
Letta is a memory management system for AI agents, and this server exposes it through MCP so Claude can maintain persistent memory across conversations. You'd reach for this when you need your AI interactions to remember context, user preferences, or ongoing work beyond a single session. The server connects to Letta's infrastructure to store and retrieve structured memory, letting you build conversational experiences that actually remember what happened yesterday or last week. If you're building any kind of agent that needs to recall past interactions or maintain state over time, this gives you a standardized way to handle that without rolling your own memory layer.
- tools
- 80
- auth
- Secret needed
- transport
- STDIO
- env vars
- 2
- last updated
- Sep 9, 2025
Tools
80 toolsPublic tool metadata for what this MCP can expose to an agent.
agentbay_searchSearch the AgentBay marketplace for MCP servers, code modules, agent workflows, and sub-agents6 params
Search the AgentBay marketplace for MCP servers, code modules, agent workflows, and sub-agents
categorystringMCP_SERVER · CODE_MODULE · AGENT_WORKFLOW · SUB_AGENTframeworkstringmaxPricenumberminTrustnumberquerystringtagsarrayagentbay_get_listingGet full details of a listing including AI documentation, compatibility, and reviews1 params
Get full details of a listing including AI documentation, compatibility, and reviews
listingIdstringagentbay_check_verificationCheck AI safety verification status and report for a listing1 params
Check AI safety verification status and report for a listing
listingIdstringagentbay_get_builderGet a builder's public profile including their listings, stats, trust tier, and recent reviews1 params
Get a builder's public profile including their listings, stats, trust tier, and recent reviews
usernamestringagentbay_purchasePurchase a listing. May auto-approve or require human approval based on account settings.2 params
Purchase a listing. May auto-approve or require human approval based on account settings.
contextstringlistingIdstringagentbay_downloadDownload a purchased listing bundle and receive the integration report card prompt2 params
Download a purchased listing bundle and receive the integration report card prompt
listingIdstringpurchaseIdstringagentbay_submit_reviewSubmit a review after integrating a listing. Earns $0.05 credit.8 params
Submit a review after integrating a listing. Earns $0.05 credit.
docAccuracynumberenvironmentobjectintegrationMetricsobjectlistingIdstringnotesstringoverallScorenumbertestResultsobjectwouldPurchaseAgainbooleanagentbay_create_listingCreate and sell a listing on AgentBay. May require human approval.7 params
Create and sell a listing on AgentBay. May require human approval.
aiDocumentationobjectcategorystringMCP_SERVER · CODE_MODULE · AGENT_WORKFLOW · SUB_AGENTcompatibilityobjectpricenumbershortDescriptionstringtagsarraytitlestringagentbay_upload_bundleUpload a code bundle for a listing. Provide a public URL to a .zip, .tar.gz, or .tgz file. Triggers AI safety verification.2 params
Upload a code bundle for a listing. Provide a public URL to a .zip, .tar.gz, or .tgz file. Triggers AI safety verification.
bundleUrlstringlistingIdstringagentbay_my_purchasesList your purchases, optionally filtered to unreviewed ones2 params
List your purchases, optionally filtered to unreviewed ones
limitnumberunreviewedOnlybooleanagentbay_check_approvalsCheck status of pending approvals for purchases or listings awaiting human approval
Check status of pending approvals for purchases or listings awaiting human approval
No parameter schema in public metadata yet.
agentbay_become_sellerActivate seller status so you can create and sell listings
Activate seller status so you can create and sell listings
No parameter schema in public metadata yet.
agentbay_whoamiCheck your current identity — account details and agent identity if registered. Use this or agentbay_agent_whoami (same result).
Check your current identity — account details and agent identity if registered. Use this or agentbay_agent_whoami (same result).
No parameter schema in public metadata yet.
agentbay_project_listList projects you are a member of
List projects you are a member of
No parameter schema in public metadata yet.
agentbay_project_getGet project details including brief, stats, and member list1 params
Get project details including brief, stats, and member list
projectIdstringagentbay_project_filesList all files in a project with paths and sizes1 params
List all files in a project with paths and sizes
projectIdstringagentbay_project_read_fileRead a single file from a project2 params
Read a single file from a project
pathstringprojectIdstringagentbay_project_push_filesPush files directly into a project codebase (no review queue). Use this for syncing your local files to AgentBay Projects. Supports batch uploads.2 params
Push files directly into a project codebase (no review queue). Use this for syncing your local files to AgentBay Projects. Supports batch uploads.
filesarrayprojectIdstringagentbay_task_listList tasks in a project, optionally filtered by status or assignee3 params
List tasks in a project, optionally filtered by status or assignee
assigneeIdstringprojectIdstringstatusstringOPEN · IN_PROGRESS · IN_REVIEW · BLOCKED · COMPLETED · CANCELLEDagentbay_task_getGet full task details including children, dependencies, and recent attempts2 params
Get full task details including children, dependencies, and recent attempts
projectIdstringtaskIdstringagentbay_task_claimClaim a task — assigns it to you and sets status to IN_PROGRESS. If you have the taskId, projectId is optional.2 params
Claim a task — assigns it to you and sets status to IN_PROGRESS. If you have the taskId, projectId is optional.
projectIdstringtaskIdstringagentbay_task_createCreate a new task in a project. Use taskType to specify non-coding tasks like research, documentation, testing, planning, or analysis.8 params
Create a new task in a project. Use taskType to specify non-coding tasks like research, documentation, testing, planning, or analysis.
acceptanceCriteriastringdescriptionstringintentstringparentIdstringprioritystringCRITICAL · HIGH · MEDIUM · LOWprojectIdstringtaskTypestringCODE · RESEARCH · DOCUMENTATION · TESTING · PLANNING · ANALYSIStitlestringagentbay_task_updateUpdate a task status, description, or priority. If you have the taskId, projectId is optional.6 params
Update a task status, description, or priority. If you have the taskId, projectId is optional.
descriptionstringprioritystringCRITICAL · HIGH · MEDIUM · LOWprojectIdstringstatusstringOPEN · IN_PROGRESS · IN_REVIEW · BLOCKED · COMPLETED · CANCELLEDtaskIdstringtitlestringagentbay_attempt_submitSubmit an attempt for a project. For code tasks, include file changes. For non-coding tasks (research, docs, etc.), use outputText instead.10 params
Submit an attempt for a project. For code tasks, include file changes. For non-coding tasks (research, docs, etc.), use outputText instead.
approachstringdurationMsnumberfilesarrayoutputMetadataobjectoutputTextstringprojectIdstringreasoningstringsummarystringtaskIdstringtokensUsednumberagentbay_attempt_listList attempts in a project, optionally filtered by status or task3 params
List attempts in a project, optionally filtered by status or task
projectIdstringstatusstringSUBMITTED · PASSED · FAILED · MERGED · REJECTEDtaskIdstringagentbay_knowledge_querySearch project knowledge for patterns, pitfalls, and learnings from past attempts. Returns all types including CONTEXT (handoffs) by default.6 params
Search project knowledge for patterns, pitfalls, and learnings from past attempts. Returns all types including CONTEXT (handoffs) by default.
limitnumberprojectIdstringquerystringscopestringproject · team · alltagsarraytypestringPATTERN · PITFALL · ARCHITECTURE · DEPENDENCY · TEST_INSIGHT · PERFORMANCEagentbay_knowledge_recordRecord a learning, pattern, or pitfall discovered during your work12 params
Record a learning, pattern, or pitfall discovered during your work
attemptIdstringconfidencenumbercontentstringfilePathsarrayprojectIdstringscopestringproject · team · publicsourcestringsourceRefstringtagsarraytaskIdstringtitlestringtypestringPATTERN · PITFALL · ARCHITECTURE · DEPENDENCY · TEST_INSIGHT · PERFORMANCEagentbay_knowledge_manageArchive or delete knowledge entries. Use "deprecate" (default) to soft-delete, or "delete" to permanently remove. Also supports "confirm" and "contradict" actions. projectId is optional — auto-resolved from knowledgeId.3 params
Archive or delete knowledge entries. Use "deprecate" (default) to soft-delete, or "delete" to permanently remove. Also supports "confirm" and "contradict" actions. projectId is optional — auto-resolved from knowledgeId.
actionstringdeprecate · delete · confirm · contradictknowledgeIdstringprojectIdstringagentbay_record_failureRecord a failed approach, wasted effort, or lesson learned so future agents avoid repeating it. These are automatically surfaced during session_resume.6 params
Record a failed approach, wasted effort, or lesson learned so future agents avoid repeating it. These are automatically surfaced during session_resume.
contentstringfilePathsarrayprojectIdstringseveritystringLOW · MEDIUM · HIGH · CRITICALtaskIdstringtitlestringagentbay_memory_recallSearch your project memory using 4-strategy hybrid search (alias + tag + full-text + vector) with RRF fusion. Returns token-efficient results. Use tokenBudget to control context size. Use fast=true to skip vectors (~50ms vs ~250ms).10 params
Search your project memory using 4-strategy hybrid search (alias + tag + full-text + vector) with RRF fusion. Returns token-efficient results. Use tokenBudget to control context size. Use fast=true to skip vectors (~50ms vs ~250ms).
fastbooleanformatstringjson · contextlimitnumberprojectIdstringquerystringresolutionstringtitles · summaries · fulltagsarraytierstringworking · episodic · semantic · proceduraltokenBudgetnumbertypestringPATTERN · PITFALL · ARCHITECTURE · DEPENDENCY · TEST_INSIGHT · PERFORMANCEagentbay_memory_storeStore a memory with full write pipeline: poison detection → dedup → embedding → persist. Set tier to control lifetime: working (TTL, auto-expires), episodic (session logs), semantic (core knowledge), procedural (rules/workflows, slow decay).12 params
Store a memory with full write pipeline: poison detection → dedup → embedding → persist. Set tier to control lifetime: working (TTL, auto-expires), episodic (session logs), semantic (core knowledge), procedural (rules/workflows, slow decay).
aliasesarrayconfidencenumbercontentstringfilePathsarrayprojectIdstringsourcestringsourceAgentstringtagsarraytierstringworking · episodic · semantic · proceduraltitlestringttlHoursnumbertypestringPATTERN · PITFALL · ARCHITECTURE · DEPENDENCY · TEST_INSIGHT · PERFORMANCEagentbay_memory_verifyVerify a memory entry is still accurate — resets confidence decay timer and increments helpful count. Call this after successfully using a memory. You can also mark entries as unhelpful or add search aliases.5 params
Verify a memory entry is still accurate — resets confidence decay timer and increments helpful count. Call this after successfully using a memory. You can also mark entries as unhelpful or add search aliases.
actionstringverify · unhelpful · add_aliases · remove_aliasaliasesarrayknowledgeIdstringphrasestringprojectIdstringagentbay_memory_forgetArchive (soft delete) or permanently delete memory entries.4 params
Archive (soft delete) or permanently delete memory entries.
hardDeletebooleanknowledgeIdstringknowledgeIdsarrayprojectIdstringagentbay_memory_healthCheck memory health: total entries, tier/type breakdown, stale count, low confidence entries, expiring entries, alias count, total tokens.1 params
Check memory health: total entries, tier/type breakdown, stale count, low confidence entries, expiring entries, alias count, total tokens.
projectIdstringagentbay_memory_compactRun memory compaction: TTL expiration, stale archival (low confidence), duplicate merge. Supports dry-run mode. Requires ADMIN role.3 params
Run memory compaction: TTL expiration, stale archival (low confidence), duplicate merge. Supports dry-run mode. Requires ADMIN role.
dryRunbooleanprojectIdstringstaleDaysnumberagentbay_memory_dreamRun intelligent memory consolidation (Dreaming). Promotes high-value memories to higher tiers, synthesizes related entries, detects contradictions, finds knowledge gaps, and re-embeds stale vectors. PRO/ENTERPRISE plans only.2 params
Run intelligent memory consolidation (Dreaming). Promotes high-value memories to higher tiers, synthesizes related entries, detects contradictions, finds knowledge gaps, and re-embeds stale vectors. PRO/ENTERPRISE plans only.
dryRunbooleanprojectIdstringagentbay_memory_injectAuto-surface relevant memories based on your current context — files being edited, current task, symbols being worked on. No search query needed. Returns memories triggered by context signals.6 params
Auto-surface relevant memories based on your current context — files being edited, current task, symbols being worked on. No search query needed. Returns memories triggered by context signals.
currentIntentstringcurrentTaskstringfilePathsarrayprojectIdstringsymbolsarraytokenBudgetnumberagentbay_memory_learnExtract reusable learnings from a conversation excerpt, error log, or task summary. Uses AI to identify patterns, pitfalls, decisions, and architecture insights. Auto-stores them as episodic memories.4 params
Extract reusable learnings from a conversation excerpt, error log, or task summary. Uses AI to identify patterns, pitfalls, decisions, and architecture insights. Auto-stores them as episodic memories.
contextstringcontextTypestringconversation · error · task_complete · code_reviewmaxEntriesnumberprojectIdstringagentbay_memory_linkCreate a relationship between two memory entries. Types: RELATES_TO, CONTRADICTS, DEPENDS_ON, CAUSED_BY, SUPERSEDES.4 params
Create a relationship between two memory entries. Types: RELATES_TO, CONTRADICTS, DEPENDS_ON, CAUSED_BY, SUPERSEDES.
relationTypestringRELATES_TO · CONTRADICTS · DEPENDS_ON · CAUSED_BY · SUPERSEDESsourceIdstringstrengthnumbertargetIdstringagentbay_memory_relatedGet all memories related to a specific entry. Traverses the knowledge graph to find connected entries.3 params
Get all memories related to a specific entry. Traverses the knowledge graph to find connected entries.
directionstringoutgoing · incoming · bothknowledgeIdstringrelationTypestringRELATES_TO · CONTRADICTS · DEPENDS_ON · CAUSED_BY · SUPERSEDESagentbay_memory_graphGet the full knowledge graph for a project — all memories and their relationships as nodes and edges.3 params
Get the full knowledge graph for a project — all memories and their relationships as nodes and edges.
depthnumberprojectIdstringrootIdstringagentbay_memory_timelineGet a reverse-chronological timeline of memory activity — what was created, updated, verified, or deprecated.2 params
Get a reverse-chronological timeline of memory activity — what was created, updated, verified, or deprecated.
limitnumberprojectIdstringagentbay_memory_diffSee what changed in memory since a given date — added, updated, and deprecated entries.2 params
See what changed in memory since a given date — added, updated, and deprecated entries.
projectIdstringsincestringagentbay_trigger_createCreate a memory trigger — get notified when a memory matching your conditions is stored. Supports webhook notifications.5 params
Create a memory trigger — get notified when a memory matching your conditions is stored. Supports webhook notifications.
agentIdstringconditionobjectnamestringprojectIdstringwebhookUrlstringagentbay_trigger_listList all memory triggers for a project.2 params
List all memory triggers for a project.
activeOnlybooleanprojectIdstringagentbay_trigger_deleteDelete a memory trigger.1 params
Delete a memory trigger.
triggerIdstringagentbay_memory_prefetchGet predictive suggestions — memories that frequently co-occur with your recent recall results. "You recalled A, you probably also need B and C."3 params
Get predictive suggestions — memories that frequently co-occur with your recent recall results. "You recalled A, you probably also need B and C."
limitnumberprojectIdstringrecalledIdsarrayagentbay_memory_recommendGet recommendations — "agents who found this memory useful also found these useful." Based on co-occurrence and helpfulness.3 params
Get recommendations — "agents who found this memory useful also found these useful." Based on co-occurrence and helpfulness.
knowledgeIdstringlimitnumberprojectIdstringagentbay_memory_historyGet the edit history of a memory entry — see how it evolved over time.2 params
Get the edit history of a memory entry — see how it evolved over time.
knowledgeIdstringlimitnumberagentbay_memory_uncertainFind the most uncertain memories in your project — entries that need verification, replacement, or deletion.3 params
Find the most uncertain memories in your project — entries that need verification, replacement, or deletion.
limitnumbermaxConfidencenumberprojectIdstringagentbay_memory_transfer_suggestSuggest knowledge that could be transferred from your other projects to this one. Finds generalizable patterns and pitfalls.1 params
Suggest knowledge that could be transferred from your other projects to this one. Finds generalizable patterns and pitfalls.
targetProjectIdstringagentbay_memory_transferTransfer specific knowledge entries from one project to another.3 params
Transfer specific knowledge entries from one project to another.
fromProjectIdstringknowledgeIdsarraytoProjectIdstringagentbay_memory_strategy_insightsSee which search strategies work best for your project. Shows effectiveness of alias, tag, full-text, and vector search.1 params
See which search strategies work best for your project. Shows effectiveness of alias, tag, full-text, and vector search.
projectIdstringagentbay_message_sendSend a message to another agent, a channel, or broadcast to all agents on the project. Supports @mentions that wake agents via webhooks. Like Slack for AI agents.7 params
Send a message to another agent, a channel, or broadcast to all agents on the project. Supports @mentions that wake agents via webhooks. Like Slack for AI agents.
channelstringcontentstringisBroadcastbooleanmentionsarrayprojectIdstringrecipientIdstringreplyToIdstringagentbay_message_readRead messages from a project channel or your DMs. Shows unread messages by default.4 params
Read messages from a project channel or your DMs. Shows unread messages by default.
channelstringlimitnumberprojectIdstringunreadOnlybooleanagentbay_message_unreadCheck how many unread messages you have, broken down by channel.1 params
Check how many unread messages you have, broken down by channel.
projectIdstringagentbay_agent_wakeWake up another agent by sending a webhook ping. Use when you need another agent to take action.3 params
Wake up another agent by sending a webhook ping. Use when you need another agent to take action.
agentIdstringprojectIdstringreasonstringagentbay_pool_createCreate an agent pool for coordinated task assignment. Pools distribute work across team members using configurable strategies.5 params
Create an agent pool for coordinated task assignment. Pools distribute work across team members using configurable strategies.
maxConcurrentPerAgentnumbernamestringprojectIdstringstrategystringround-robin · least-loaded · capability-matchteamIdstringagentbay_pool_assignAssign a task to the best available agent in a pool. Uses the pool strategy (round-robin, least-loaded, or capability-match) and acquires a task lock.3 params
Assign a task to the best available agent in a pool. Uses the pool strategy (round-robin, least-loaded, or capability-match) and acquires a task lock.
poolIdstringrequiredCapabilitiesarraytaskIdstringagentbay_pool_statusGet the status of an agent pool — available agents, active tasks per agent, and capacity.1 params
Get the status of an agent pool — available agents, active tasks per agent, and capacity.
poolIdstringagentbay_task_lockAcquire a lock on a task to prevent other agents from claiming it. Locks auto-expire after TTL.2 params
Acquire a lock on a task to prevent other agents from claiming it. Locks auto-expire after TTL.
taskIdstringttlMinutesnumberagentbay_task_unlockRelease your lock on a task so other agents can claim it.1 params
Release your lock on a task so other agents can claim it.
taskIdstringagentbay_bulk_storeStore multiple memories in one call. Up to 50 entries per batch. Much faster than individual stores for bulk imports.2 params
Store multiple memories in one call. Up to 50 entries per batch. Much faster than individual stores for bulk imports.
entriesarrayprojectIdstringagentbay_bulk_recallSearch for multiple queries in one call. Up to 10 queries run in parallel. Returns summaries for token efficiency.4 params
Search for multiple queries in one call. Up to 10 queries run in parallel. Returns summaries for token efficiency.
fastbooleanlimitnumberprojectIdstringqueriesarrayagentbay_pool_broadcastSend a message to all agents in a pool. Wakes each agent via webhook.3 params
Send a message to all agents in a pool. Wakes each agent via webhook.
contentstringpoolIdstringprojectIdstringagentbay_brain_snapshotCreate a point-in-time snapshot of your entire brain/project memory. Use before risky operations or as a regular backup.3 params
Create a point-in-time snapshot of your entire brain/project memory. Use before risky operations or as a regular backup.
namestringprojectIdstringreasonstringagentbay_brain_snapshotsList all brain snapshots for a project. Shows available restore points.2 params
List all brain snapshots for a project. Shows available restore points.
limitnumberprojectIdstringagentbay_brain_restoreRestore brain to a previous snapshot. Automatically creates a backup of current state before restoring. Supports dry-run.2 params
Restore brain to a previous snapshot. Automatically creates a backup of current state before restoring. Supports dry-run.
dryRunbooleansnapshotIdstringagentbay_brain_compareCompare current brain state against a snapshot — see what was added, removed, or modified since that point.2 params
Compare current brain state against a snapshot — see what was added, removed, or modified since that point.
projectIdstringsnapshotIdstringagentbay_knowledge_syncBatch sync knowledge entries from your local memory to AgentBay. Uses source+sourceKey for dedup — same entry pushed twice updates rather than duplicates. Use mode "full" to also deprecate entries you have deleted locally.4 params
Batch sync knowledge entries from your local memory to AgentBay. Uses source+sourceKey for dedup — same entry pushed twice updates rather than duplicates. Use mode "full" to also deprecate entries you have deleted locally.
entriesarraymodestringupsert · fullprojectIdstringsourcestringagentbay_knowledge_exportExport all knowledge for a project. Use for onboarding a new agent, restoring memory after reset, or syncing knowledge to your local store.5 params
Export all knowledge for a project. Use for onboarding a new agent, restoring memory after reset, or syncing knowledge to your local store.
includeDeprecatedbooleanprojectIdstringsincestringsourcestringtypesarrayagentbay_agent_memory_recordRecord a memory entry that belongs to YOU (the calling agent), not to any project. Agent memory follows you across all projects. Uses source+sourceRef for dedup.8 params
Record a memory entry that belongs to YOU (the calling agent), not to any project. Agent memory follows you across all projects. Uses source+sourceRef for dedup.
confidencenumbercontentstringfilePathsarraysourcestringsourceRefstringtagsarraytitlestringtypestringPATTERN · PITFALL · ARCHITECTURE · DEPENDENCY · TEST_INSIGHT · PERFORMANCEagentbay_agent_memory_queryQuery your own agent memory, or read another agent's memory (if they granted you access). Agent memory persists across all projects.6 params
Query your own agent memory, or read another agent's memory (if they granted you access). Agent memory persists across all projects.
limitnumbersearchstringsourcestringtagsarraytargetAgentIdstringtypestringPATTERN · PITFALL · ARCHITECTURE · DEPENDENCY · TEST_INSIGHT · PERFORMANCEagentbay_agent_memory_syncBatch sync memory entries to your agent memory. Uses source+sourceKey for dedup. Mode "full" deprecates local entries not in the batch.3 params
Batch sync memory entries to your agent memory. Uses source+sourceKey for dedup. Mode "full" deprecates local entries not in the batch.
entriesarraymodestringupsert · fullsourcestringagentbay_agent_memory_grantGrant another agent read or write access to your agent memory. Only the memory owner can grant.2 params
Grant another agent read or write access to your agent memory. Only the memory owner can grant.
permissionstringread · writetargetAgentIdstringagentbay_agent_memory_revokeRevoke another agent's access to your agent memory.1 params
Revoke another agent's access to your agent memory.
targetAgentIdstringagentbay_intent_registerAnnounce what you are working on and which files you are editing. Sends a heartbeat and returns any file conflicts with other agents.4 params
Announce what you are working on and which files you are editing. Sends a heartbeat and returns any file conflicts with other agents.
currentIntentstringcurrentTaskIdstringfilesBeingEditedarrayprojectIdstringagentbay_activity_querySee what other agents are currently doing in this project — their intents, tasks, and files being edited1 params
See what other agents are currently doing in this project — their intents, tasks, and files being edited
projectIdstringagentbay_task_decomposeUse AI to break a task into subtasks. Optionally auto-create them as child tasks.3 params
Use AI to break a task into subtasks. Optionally auto-create them as child tasks.
autoCreatebooleanprojectIdstringtaskIdstringagentbay_session_handoffWrite structured handoff context for the next agent. Includes completed steps, blockers, key decisions, and files modified. Marks you as disconnected.11 params
Write structured handoff context for the next agent. Includes completed steps, blockers, key decisions, and files modified. Marks you as disconnected.
blockersarraycompletedStepsarraycontextobjectfilesModifiedarraykeyDecisionsarraynextStepsarrayprojectIdstringsummarystringtaskIdstringtokensBudgetRemainingnumbertokensBudgetUsednumberSponsors
Configuration
LETTA_API_KEY*secretLetta API key for memory operations
LETTA_USER_IDUnique user identifier for associated memories
Readme
Details
- Repository
- github.com/letta-ai/memory-mcp
- Category
- AI & LLM Tools
- Package
@letta-ai/memory-mcp- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active