Cursor Memory MCP Server

A persistent memory storage MCP (Model Context Protocol) server for Cursor IDE. Allows the AI assistant to remember information across sessions.

Features

Store memories with global or project-specific scope
Tag-based organization for easy categorization
Search memories by content or tags
CRUD operations - create, read, update, delete memories
Context matching - update/delete by description, not just ID
SQLite backend for performance and reliability
Docker deployment for easy setup

Quick Start

1. Build and Run with Docker

docker-compose up -d --build

2. Add to Cursor MCP Configuration

Edit ~/.cursor/mcp.json:

{
  "mcpServers": {
    "cursor-memory": {
      "url": "http://localhost:8081/sse",
      "transport": "sse"
    }
  }
}

3. Restart Cursor

The memory tools will now be available to the AI assistant.

Available Tools

Tool	Description
`memory_store`	Store a new memory
`memory_recall`	Retrieve all memories (call on session start)
`memory_search`	Search memories by keyword/tag
`memory_list`	List all memories with index numbers
`memory_update`	Update a memory by ID or context
`memory_delete`	Delete a memory by ID or context

Usage Examples

Storing a Memory

Tell Cursor: "Remember that I prefer tabs over spaces"

The agent will:

Optimize the content
Ask for scope (global/project)
Suggest tags
Confirm before storing

Recalling Memories

Tell Cursor: "Check your memory" or "What do you remember?"

Searching Memories

Tell Cursor: "Check your memory for coding preferences"

Managing Memories

"List all memories"
"Delete memory #3"
"Update the memory about indentation to prefer 4 spaces"

Development

Local Development (without Docker)

# Install dependencies
npm install

# Run in development mode
npm run dev

# Build for production
npm run build
npm start

Environment Variables

Variable	Default	Description
`PORT`	`8081`	HTTP server port
`DATA_DIR`	`./data`	SQLite database directory
`NODE_ENV`	`development`	Environment mode

Architecture

┌─────────────────┐     SSE      ┌──────────────────────┐
│   Cursor IDE    │◄────────────►│  Memory MCP Server   │
│   (AI Agent)    │              │  (Express + SQLite)  │
└─────────────────┘              └──────────────────────┘
                                           │
                                           ▼
                                    ┌─────────────┐
                                    │  SQLite DB  │
                                    │  memory.db  │
                                    └─────────────┘

Port Configuration

This server runs on port 8081 by default to avoid conflicts with other MCP servers (e.g., jana on 8080).

License

MIT

cursor-memory-mcp