Cursor’s AI-powered development environment integrates natively with Basic Memory through the Model Context Protocol (MCP), enabling persistent context across coding sessions.

Setup

Configure MCP in Cursor

Cursor supports MCP natively! Configure Basic Memory following the Cursor MCP documentation.

Add to Cursor’s MCP configuration:

{
  "mcpServers": {
    "basic-memory": {
      "command": "uvx",
      "args": ["basic-memory", "mcp"]
    }
  }
}

Install Basic Memory (optional)

# Install Basic Memory
uv tool install basic-memory

# Or with pip
pip install basic-memory

Verify Installation

In Cursor, check that Basic Memory tools are available by asking the AI:

You: "What tools do you have access to?"

You should see Basic Memory tools listed, including note creation, search, and project management.

Quick Start

Once configured, you can immediately start using Basic Memory in your Cursor conversations:

You: "Create a Basic Memory project for this codebase in the docs folder"
Cursor: [Creates project configuration and folder structure]

You: "Document our architecture decisions as we make them"
Cursor: [Creates structured notes with observations and relations]

MCP Integration Benefits

Cursor’s native MCP support enables seamless Basic Memory integration with:

  • Direct tool access in AI conversations
  • Real-time knowledge base queries
  • Persistent context across coding sessions
  • No manual content transfer needed

Available Tools

Through MCP, Cursor can access all Basic Memory tools:

  • write_note - Create structured documentation
  • read_note - Access existing knowledge
  • search_notes - Find relevant information
  • edit_note - Update documentation incrementally
  • recent_activity - Check what you’ve been working on
  • project management - Switch between different knowledge bases

Troubleshooting

Common Issues

Alternative Integration

If MCP setup doesn’t work immediately, you can also:

File-Based Editing

Edit Basic Memory notes directly in Cursor with full IDE features

CLI Integration

Use Basic Memory CLI tools from Cursor’s integrated terminal

Parallel Usage

Use Claude Desktop alongside Cursor for knowledge management

Manual Sync

Manually sync changes using basic-memory sync

Next Steps