Basic Memory Cloud is Live!
Try Now

Cursor

Set up Basic Memory with Cursor for AI-powered development with persistent memory

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

Cloud Setup

Basic Memory Cloud provides hosted MCP access with no local installation required.

Sign Up

Create your account at app.basicmemory.com

Configure Remote MCP in Cursor

In Cursor, go to Settings → Developer → Edit Config

Select MCP Tools and click Add Custom MCP

Add Basic Memory Cloud configuration:

{
  "mcpServers": {
    "basic-memory-cloud": {
      "url": "https://cloud.basicmemory.com/mcp"
    }
  }
}

Authenticate

Follow the OAuth flow to grant Cursor access to your Basic Memory account

Verify Setup

In Cursor, ask the AI:

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

You should see Basic Memory tools listed

See the Cloud Setup Guide for detailed instructions and troubleshooting.


Local 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 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 - Work with multiple 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

Next Steps

Built with ❤️ by Basic Memory