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

Pre-release Version (Latest Development)

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

Stable Version

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

Local Development

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

AI Assistant 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

Session 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

⚠️ Agent 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

Requirements

• Node.js: 16.0.0 or higher
• MCP Client: Claude Desktop, Cursor, Windsurf, Cline, Roo, etc.
• Memory: 100MB RAM minimum for typical usage
• Platform: Windows, macOS, Linux (cross-platform)

Links & Resources

• Official Website: pickle.cabbages.work
• GitHub Repository: Justar96/memory-pickle-mcp
• NPM Package: @cabbages/memory-pickle-mcp
• Pre-release: @cabbages-pre/memory-pickle-mcp-pre

Documentation

• Complete Tools Reference - All 13 tools with examples
• Usage Guide - Workflows and best practices
• Changelog - Version history and updates

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