> ## Documentation Index
> Fetch the complete documentation index at: https://memory.basicmachines.co/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.

## Setup

### Configure MCP in Cursor

Cursor supports MCP natively! Configure Basic Memory following the [Cursor MCP documentation](https://docs.cursor.com/context/model-context-protocol).

**Add to Cursor's MCP configuration:**

```json theme={null}
{
  "mcpServers": {
    "basic-memory": {
      "command": "uvx",
      "args": ["basic-memory", "mcp"]
    }
  }
}
```

### Install Basic Memory (optional)

```bash theme={null}
# 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

> [!NOTE]
>
> 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

> [accordion] MCP tools not appearing in Cursor
>
> **Solutions:**
>
> * Verify Basic Memory is installed: `basic-memory --version`
> * Check MCP configuration syntax in Cursor settings
> * Restart Cursor after configuration changes
> * Try absolute path to uvx if needed

> [accordion] Tools appear but don't work
>
> **Solutions:**
>
> * Check Basic Memory sync status: `basic-memory status`
> * Verify project directory permissions
> * Ensure uvx can find basic-memory: `which basic-memory`

> [accordion] Performance issues
>
> **Solutions:**
>
> * Large knowledge bases may slow responses
> * Consider splitting into multiple projects
> * Check available disk space

## Alternative Integration

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

> [card] File-Based Editing
>
> Edit Basic Memory notes directly in Cursor with full IDE features

> [card] CLI Integration
>
> Use Basic Memory CLI tools from Cursor's integrated terminal

> [card] Parallel Usage
>
> Use Claude Desktop alongside Cursor for knowledge management

> [card] Manual Sync
>
> Manually sync changes using `basic-memory sync`

## Next Steps

> [card] [Project Documentation](https://memory.basicmachines.co/how-to/project-documentation.md)
>
> Learn how to document your development projects

> [card] [Architecture Decisions](https://memory.basicmachines.co/how-to/architecture-decisions)
>
> Record and track technical decisions

> [card] [CLI Reference](https://memory.basicmachines.co/guides/cli-reference.md)
>
> Master command line tools for development

> [card] [Knowledge Format](https://memory.basicmachines.co/guides/knowledge-format.md)
>
> Structure your development documentation


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.