Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@cabbages/memory-pickle-mcp) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

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

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

Data Loss Prevention

Tell Agent to use generate_handoff_summary before ending sessions
Export critical data with export_session
Save important decisions as markdown files
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