Memory Pickle MCP

A project management and session memory tool for AI agents to track projects, tasks, and context during chat sessions.

View on GitHub →

Memory Pickle MCP

Project management and session memory for AI agents. Provides 13 comprehensive MCP tools for tracking projects, tasks, and context during AI coding sessions.

suggestion

for kilo , cline , roo perform best with code mode your agent will not lose track. there are some struggle with HITL

Quick Start

Stable Version

{
  "mcpServers": {
    "memory-pickle": {
      "command": "npx",
      "args": ["-y", "@cabbages/memory-pickle-mcp"]
    }
  }
}

Compatibility

Extensively Tested & Optimized For:

  • Cursor , Windsurf , Cline, Roo, Kilo Mode Code

Additional Support:

  • Claude Desktop (direct MCP integration)
  • VS Code with MCP extensions

Architecture Overview

Memory-Only Storage Architecture:

  • All data exists only during the current chat session
  • No files created on disk - zero filesystem dependencies
  • Data automatically cleared when session ends
  • Blazing fast performance with in-memory operations
  • Complete session isolation for security

13-Tool Comprehensive System:

  • 4 Read Tools: State recall, task listing, project overview, detailed task info
  • 5 Write Tools: Project/task creation and updates, context switching
  • 2 Memory Tools: Information storage and contextual search
  • 2 Session Tools: Data export and handoff summary generation

Features

Hierarchical Task Organization

# Create parent task
create_task:
  title: "Build Authentication System"
  priority: "high"

# Create subtasks
create_task:
  title: "Implement login API"
  parent_id: "task_123"  # Links to parent
  
create_task:
  title: "Add password reset flow"
  parent_id: "task_123"

Progress Tracking & Blockers

# Comprehensive task updates
update_task:
  task_id: "task_123"
  progress: 75
  notes: ["API endpoints complete", "Working on validation"]
  blockers: ["Waiting for security review", "Database schema pending"]
  completed: false

Memory System with Importance

# Store critical decisions
remember_this:
  content: "Switched from JWT to session cookies for security"
  importance: "critical"
  project_id: "proj_auth"

# Search by importance level
recall_context:
  query: "security decision"
  importance: "critical"
  limit: 5

Workflow

Session Handoff

# Generate clean transition summary
generate_handoff_summary:
  format: "detailed"
  project_id: "current"

# Export for permanent storage
export_session:
  format: "markdown"
  include_handoff: true
  raw_markdown: true  # Clean output for processing

Integration Notes

  • Context switching: Agents may lose context between tool calls (in some case)
  • State synchronization: Use recall_state to refresh context
  • Error handling: Tools provide detailed error information send me issues <3

Requirements

  • Node.js: 16.0.0 or higher

Links & Resources

Local Development

{
  "mcpServers": {
    "memory-pickle-dev": {
      "command": "node",
      "args": ["build/index.js"],
      "cwd": "/path/to/your/memory-pickle-mcp"
    }
  }
}

Pre-release Version (Latest Development)

{
  "mcpServers": {
    "memory-pickle-pre": {
      "command": "npx",
      "args": ["-y", "@cabbages-pre/memory-pickle-mcp-pre@latest"]
    }
  }
}

Documentation

Troubleshooting

Tools Not Working

  1. Update to latest version: npx -y @cabbages/memory-pickle-mcp Use @latest flag
  2. Verify MCP client configuration in settings
  3. Check Node.js version: node --version
  4. Restart MCP server for complete reset

Data Loss Prevention

  1. Tell Agent to use generate_handoff_summary before ending sessions
  2. Export critical data with export_session
  3. Save important decisions as markdown files
  4. Document project state in external files

Version Information

Current Version: 1.3.9

Recent Changes:

  • 13 comprehensive tools for complete project management
  • Advanced hierarchical task organization with parent-child relationships
  • Code location linking for development context
  • Importance-based memory classification system
  • Comprehensive session export and handoff capabilities
  • Optimized for modern AI coding assistants (Cursor, Cline, Roo, etc.)

License

Apache 2.0 - See LICENSE for details

Related Servers