---
name: Agent Memory MCP
slug: agent-memory-mcp
category: AI Engineering
description: Agent Memory MCP provides a persistent, searchable memory bank for AI agents, exposing MCP tools to search, write, read, and analyze project knowledge. Use it when an agent needs long-term memory synced with project documentation.
github: "https://github.com/davila7/claude-code-templates/tree/main/cli-tool/components/skills/ai-research/agent-memory-mcp"
language: Python
stars: 30236
forks: 3396
install: "npx degit https://github.com/davila7/claude-code-templates/tree/main/cli-tool/components/skills/ai-research/agent-memory-mcp ~/.claude/skills/agent-memory-mcp"
installs_to: ~/.claude/skills/agent-memory-mcp
source_path: cli-tool/components/skills/ai-research/agent-memory-mcp/SKILL.md
collection_size: 25
category_size: 2451
collection_url: "https://dirskills.com/collections/davila7/claude-code-templates"
added: 2026-08-14T07:11:44.371Z
last_synced: 2026-08-14T07:11:44.371Z
canonical_url: "https://dirskills.com/skills/agent-memory-mcp"
---

# Agent Memory MCP

Agent Memory MCP provides a persistent, searchable memory bank for AI agents, exposing MCP tools to search, write, read, and analyze project knowledge. Use it when an agent needs long-term memory synced with project documentation.

**Install:**

```bash
npx degit https://github.com/davila7/claude-code-templates/tree/main/cli-tool/components/skills/ai-research/agent-memory-mcp ~/.claude/skills/agent-memory-mcp
```

## README

# Agent Memory Skill

This skill provides a persistent, searchable memory bank that automatically syncs with project documentation. It runs as an MCP server to allow reading/writing/searching of long-term memories.

## Prerequisites

- Node.js (v18+)

## Setup

1. **Clone the Repository**:
   Clone the `agentMemory` project into your agent's workspace or a parallel directory:

   ```bash
   git clone https://github.com/webzler/agentMemory.git .agent/skills/agent-memory
   ```

2. **Install Dependencies**:

   ```bash
   cd .agent/skills/agent-memory
   npm install
   npm run compile
   ```

3. **Start the MCP Server**:
   Use the helper script to activate the memory bank for your current project:

   ```bash
   npm run start-server <project_id> <absolute_path_to_target_workspace>
   ```

   _Example for current directory:_

   ```bash
   npm run start-server my-project $(pwd)
   ```

## Capabilities (MCP Tools)

### `memory_search`

Search for memories by query, type, or tags.

- **Args**: `query` (string), `type?` (string), `tags?` (string[])
- **Usage**: "Find all authentication patterns" -> `memory_search({ query: "authentication", type: "pattern" })`

### `memory_write`

Record new knowledge or decisions.

- **Args**: `key` (string), `type` (string), `content` (string), `tags?` (string[])
- **Usage**: "Save this architecture decision" -> `memory_write({ key: "auth-v1", type: "decision", content: "..." })`

### `memory_read`

Retrieve specific memory content by key.

- **Args**: `key` (string)
- **Usage**: "Get the auth design" -> `memory_read({ key: "auth-v1" })`

### `memory_stats`

View analytics on memory usage.

- **Usage**: "Show memory statistics" -> `memory_stats({})`

## Dashboard

This skill includes a standalone dashboard to visualize memory usage.

```bash
npm run start-dashboard <absolute_path_to_target_workspace>
```

Access at: `http://localhost:3333`