Skip to content

endlessblink/Like-I-Said-memory-mcp-server

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

49 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

Like-I-Said MCP v2

Like-I-Said v2: Task Management & Memory for Claude Desktop

npm version License: MIT

Turn Claude Desktop into your intelligent project manager. Track tasks, remember context, and maintain continuity across sessions.

๐Ÿ“š Table of Contents

๐ŸŽฏ What Makes This Different

Unlike simple memory tools, Like-I-Said v2 provides intelligent task management that understands your workflow:

  • Smart Task Tracking - Say "I finished the auth system" and Claude updates your tasks
  • Automatic Memory-Task Linking - Every decision, code snippet, and conversation links to relevant tasks
  • Natural Language Updates - No commands needed, just talk naturally about your progress
  • Cross-Session Continuity - Pick up exactly where you left off, even days later
  • Project-Based Organization - Keep multiple projects separate and organized

๐Ÿš€ Installation

Installation Methods

Option 1: Automatic Installation (Recommended)

Works for both Claude Desktop and Claude Code - one command does everything:

npx @endlessblink/like-i-said-v2@latest like-i-said-v2 install

# Or install to a specific directory:
npx @endlessblink/like-i-said-v2@latest like-i-said-v2 install --path /custom/path

This single command automatically:

  • Installs the MCP server completely (no additional commands needed)
  • Configures your Claude client (Desktop or Code)
  • Sets up necessary directories
  • No manual configuration or menu interaction required

Option 2: Claude Code Direct Registration

If you're using Claude Code and Option 1 didn't work:

claude mcp add like-i-said-memory-v2 -- npx -p @endlessblink/like-i-said-v2@latest like-i-said-v2

This registers the MCP server directly with Claude Code's configuration system.

Verify Installation

After installation:

  1. Restart your Claude client
  2. Ask Claude: "What MCP tools do you have available?"
  3. You should see 27 tools including add_memory, create_task, etc.

Example usage:

"Create a task: Build authentication system"
"Remember: We're using JWT tokens with refresh rotation"
"What am I currently working on?"

๐Ÿ–ฅ๏ธ Manual IDE Configuration

If automatic configuration fails, you can manually configure your IDE:

For Cursor

Option 1: Quick Setup (No Local Files)

// ~/.cursor/mcp.json
{
  "mcpServers": {
    "like-i-said-memory-v2": {
      "command": "npx",
      "args": ["-y", "-p", "@endlessblink/like-i-said-v2@latest", "like-i-said-v2"]
    }
  }
}

Option 2: Local Installation

  1. First run: npx -p @endlessblink/like-i-said-v2@latest like-i-said-v2 install

  2. The installer will automatically configure Cursor for you

  3. Restart Cursor and verify all 27 tools are available

For Windsurf

Option 1: Quick Setup (No Local Files)

// ~/.codeium/windsurf/mcp_config.json
{
  "mcp": {
    "servers": {
      "like-i-said-memory-v2": {
        "command": "npx",
        "args": ["-y", "-p", "@endlessblink/like-i-said-v2@latest", "like-i-said-v2"]
      }
    }
  }
}

Option 2: Local Installation

  1. First run: npx -p @endlessblink/like-i-said-v2@latest like-i-said-v2 install

  2. The installer will automatically configure Windsurf for you

  3. Restart Windsurf and verify all 27 tools are available

For VS Code with Continue

Follow the Continue extension's MCP configuration guide to add the server.

๐Ÿ“Š Running the Dashboard

The dashboard provides a visual interface for managing memories and tasks.

Starting the Dashboard

Quick Start (Recommended)

# Clone the repository
git clone https://github.com/endlessblink/Like-I-Said-memory-mcp-server.git
cd Like-I-Said-memory-mcp-server

# Windows
scripts\run-dashboard.bat

# Mac/Linux
./scripts/run-dashboard.sh

Manual Start

# If you already have the repo cloned
cd Like-I-Said-memory-mcp-server
npm install
npm run start:dashboard

Accessing the Dashboard

โšก IMPORTANT: The dashboard URL is shown when you start the server!

  1. Look for "DASHBOARD READY! Access it at:" in the console
  2. Open the URL shown (usually http://localhost:3001)
  3. IGNORE port 5173 - that's only for development
  4. The dashboard shows all memories and tasks with real-time updates
  5. Features include:
    • ๐Ÿ“Š Task progress visualization
    • ๐Ÿ” Search and filter memories
    • ๐Ÿ”— View task-memory relationships
    • ๐Ÿ“ Manage projects
    • ๐Ÿ“ค Export/import data
    • ๐Ÿ“ˆ Analytics and insights

๐Ÿ’ช Key Features

Task Management That Understands You

  • Status tracking - todo โ†’ in_progress โ†’ done โ†’ blocked
  • Smart updates - "I'm done with X" automatically updates status
  • Subtask management - Break down complex tasks
  • Progress analytics - See what you've accomplished

Memory With Purpose

  • Task-linked memories - Every memory connects to relevant tasks
  • Project organization - Separate contexts for different projects
  • Semantic search - Find information using natural language
  • Automatic categorization - Code, decisions, research, etc.

Built for Real Work

  • Dynamic path configuration - "Change my task folder to D:\Projects"
  • Environment variables - Set MEMORY_DIR and TASK_DIR
  • Windows optimized - Full Windows path support
  • Real-time dashboard - Visual interface (see console for URL)

๐Ÿ› ๏ธ Available Tools (27 Total)

Core Task Tools

  • create_task - Create tasks with automatic memory linking
  • update_task - Update status, add subtasks, link memories
  • smart_status_update - Natural language status changes ("I finished X")
  • list_tasks - View tasks by status, project, or priority
  • get_task_context - See all memories and subtasks for a task
  • get_task_status_analytics - Productivity insights and suggestions

Memory Tools

  • add_memory - Store any information with rich metadata
  • search_memories - Find information across all projects
  • list_memories - Browse memories by project or category
  • generate_dropoff - Create handoff documents for new sessions

Path Management (New in v2.6+)

  • set_memory_path - Claude can change where memories are stored
  • set_task_path - Claude can change where tasks are stored
  • get_current_paths - Check current storage locations

AI Enhancement Tools

  • enhance_memory_metadata - Generate titles and summaries
  • batch_enhance_memories - Bulk enhance multiple memories
  • validate_task_workflow - Check workflow validity
  • get_automation_suggestions - Get automation ideas
  • Plus 7 more enhancement tools...

๐Ÿ“ How It Works

Tasks and memories are stored as markdown files with rich metadata:

memories/
โ”œโ”€โ”€ project-name/
โ”‚   โ”œโ”€โ”€ 2024-07-15-auth-decision-a7b3c9.md
โ”‚   โ””โ”€โ”€ 2024-07-15-jwt-implementation-d4e8f2.md
tasks/
โ”œโ”€โ”€ project-name/
โ”‚   โ”œโ”€โ”€ TASK-00001-build-authentication.md
โ”‚   โ””โ”€โ”€ TASK-00002-add-user-dashboard.md

Each task tracks:

  • Status, priority, and timestamps
  • Linked memories and subtasks
  • Project and category assignment
  • Natural language descriptions

๐ŸŽฎ Advanced Usage

Natural Language Task Management

"I'm blocked on the payment integration because we need API credentials"
"The frontend is done but needs code review"
"What should I work on next?"
"Show me my progress this week"

Dynamic Path Configuration

"Change my memory storage to D:\AI\Memories"
"Set task directory to C:\Projects\MyApp\tasks"
"Where are my files currently stored?"

Project Switching

"Switch to the mobile-app project"
"Show me all tasks for the API project"
"What's the status across all my projects?"

๐Ÿ› Troubleshooting

"Server not connecting"

# Update to latest version
npx -p @endlessblink/like-i-said-v2@latest like-i-said-v2 install

# For Claude Code users (no local files)
claude mcp add like-i-said-memory-v2 -- npx -p @endlessblink/like-i-said-v2@latest like-i-said-v2

"Can't find memories after path change"

Your old memories stay in the original location. Either:

  • Copy them to the new location
  • Change back to the original path

Debug Mode

Set environment variable before starting Claude:

set DEBUG_MCP=true  # Windows
export DEBUG_MCP=true  # Mac/Linux

Common Issues

Windows Path Issues:

  • Use forward slashes: C:/Users/name/memories
  • Or escape backslashes: C:\\Users\\name\\memories

Port Conflicts:

  • Dashboard API uses port 3001
  • Development UI uses port 5173
  • Change with PORT environment variable if needed

๐Ÿค Contributing

Found a bug? Have a feature idea?

๐Ÿ“„ License

MIT ยฉ endlessblink


Note: This is an MCP (Model Context Protocol) server for Claude Desktop. It requires Claude Desktop or a compatible MCP client to function.

About

Like-I-Said v2 - Advanced MCP Memory and Task Management for LLM's with AI Enhancement and React Dashboard

Resources

Stars

Watchers

Forks

Packages

No packages published