A Mem MCP

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/diaaaj-a-mem-mcp

About

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list and install config. Checked Oct 25, 2026.

Tools

5 read · 2 write · 1 delete

Secrets

1 (API keys, tokens or passwords)

Install scripts

Not scanned yet

Runs as

Python package

Tools (8)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

• add_memory_note

  Save learnings to persistent memory. This builds cross-session knowledge. **SELF-COMMITMENT:** After exploring code or completing research, say: "I learned something new - saving to memory..." then IMMEDIATELY call this tool. This verbal commitment ensures you don't forget to save. **EXPLICIT TRIGGERS - Save memory when you just:** • Used Read tool to understand a file → save what you learned about it • Used Grep/Glob to find code patterns → save the pattern location • Fixed a bug or solved an error → save the solution • Discovered how components connect → save the architecture insight • Fou…

• check_task_status

  Check the status of a background memory task. **USE THIS ONLY IF:** • You need to verify that a critical memory has been stored before proceeding with dependent work • Debugging why a memory might not be appearing in search results yet **MOST OF THE TIME:** You should fire-and-forget without checking status. The background processing will complete shortly. **RETURNS:** - status: "queued" | "processing" | "completed" | "failed" - task_id: The task identifier - memory_id: Available when status="completed" - error: Error message if status="failed" - created_at, updated_at: Timestamps Tasks ar…

• delete_memory_note

  Delete incorrect or obsolete memories from the knowledge base. **WHEN TO DELETE:** • Memory contains completely wrong information that can't be fixed with update • Information is obsolete (e.g., "Feature X uses deprecated API Y" but Feature X was removed) • Duplicate memory that serves no purpose (prefer update_memory_note if consolidating) • Testing/placeholder memory created by accident **CAUTION:** Prefer update_memory_note over delete when information just needs correction. Only delete when the memory has no salvageable value. The memory system evolves connections automatically, so remo…

• read_memory_note

  Read full details of one or more memories by ID. **WHEN TO USE:** • After search returns memory IDs - read full details to get complete context • To see evolution history showing how the memory has been refined over time • To view linked memories (related concepts the system connected automatically) • To check retrieval_count and last_accessed metadata **USAGE:** • Single read: provide `memory_id` - returns the note directly • Bulk read: provide `memory_ids` list - returns dict mapping each ID to its note **RETURNS:** Complete memory with content, keywords, tags, context, links, and evoluti…

• search_memories

  CRITICAL: ALWAYS search persistent memory BEFORE starting work. This prevents re-discovering what you already know. **SELF-COMMITMENT:** When you receive a task, FIRST say: "Let me check my memory for relevant context..." then IMMEDIATELY call this tool. This verbal commitment ensures you don't skip the search. **EXPLICIT TRIGGERS - Search memory when:** • User asks "how does X work?" → search("X architecture") • User asks to fix/debug something → search("error X solution") • User asks about a file/component → search("component-name") • User asks to implement something → search("similar feat…

• search_memories_agentic

  Advanced memory search that follows the knowledge graph - returns semantically similar memories PLUS their linked neighbors. **WHEN TO USE THIS INSTEAD OF search_memories:** • Complex architectural questions spanning multiple components • Need to understand relationships between concepts • Simple search_memories gave limited results but you need more context **HOW IT WORKS:** 1. Finds semantically similar memories (like search_memories) 2. ALSO retrieves linked memories through the knowledge graph 3. Returns expanded result set showing knowledge clusters **RETURNS:** Metadata only (id, cont…

• search_memories_by_time

  Search memories within a specific time period. **IMPORTANT:** You must convert natural language time expressions to YYYYMMDDHHMM format before calling. Use your knowledge of today's date to calculate the correct timestamps. **Examples of conversion (assuming today is 2026-01-14):** • "yesterday" → time_from="202601130000", time_to="202601132359" • "last week" → time_from="202601070000", time_to="202601132359" • "last Wednesday" → Calculate that date, e.g. time_from="202601080000", time_to="202601082359" • "past 3 hours" → time_from=3 hours ago from now, time_to=now • "this month" → time_from…

• update_memory_note

  Update existing memory when you learn more or need to correct information. **USE THIS PROACTIVELY WHEN:** • You discover additional details about something already in memory (e.g., "I stored info about the auth flow, but now found it also handles rate limiting") • Initial understanding was incomplete or partially incorrect • You learn edge cases or exceptions to a previously stored pattern • Context changes (e.g., a dependency was updated, changing how something works) **IMPORTANT:** Keep memories accurate! Update rather than creating duplicate memories when you learn more about an existing …

Signals

Stars

35

Forks

3

Open issues

0

Weekly downloads

65

Last commit

Jan 17, 2026 (9 months ago)

Last release

Jan 9, 2026 (9 months ago)

Last package publish

Jan 17, 2026 (9 months ago)

From GitHub (fetched Oct 24, 2026) and the package registry.

Details

Registry name

io.github.DiaaAj/a-mem-mcp

Version

0.2.1

Auth

API key

Packages

pypi a-mem

License

MIT

Repository

github.com/DiaaAj/a-mem-mcp

First seen

Oct 24, 2026

Last checked

Oct 25, 2026

Source

Official MCP Registrygithub-graphql