Cursor Setup

Cursor MCP Setup

Configure Forge as an MCP server for Cursor in 3 minutes.

Prerequisites

Install Forge

npm install -g @automagik/forge

Get Your Project ID

npx automagik-forge

Copy the UUID from your browser URL:

http://localhost:3000/projects/a1b2c3d4-e5f6-7890-abcd-ef1234567890/tasks
                                ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
                                          Your Project ID

Configuration

Option 1: Basic Mode (Recommended)

Open Cursor Settings

Press Cmd/Ctrl + ,
Or go to Cursor → Settings

Search for MCP

Type “MCP” in the settings search box

Add Configuration

Add this to your MCP configuration:

{
  "mcp.servers": {
    "automagik-forge": {
      "command": "npx",
      "args": ["automagik-forge", "--mcp"],
      "projectId": "your-project-uuid-here"
    }
  }
}

Replace your-project-uuid-here with your actual Project ID.

Reload Window

Press Cmd/Ctrl + R to reload Cursor
Or restart Cursor completely

Test

Try: "Create a task to add a README file"Cursor’s AI should create the task via MCP!

Option 2: Advanced Mode

For power users who need full Forge control:

{
  "mcp.servers": {
    "automagik-forge": {
      "command": "npx",
      "args": ["automagik-forge", "--mcp-advanced"],
      "projectId": "your-project-uuid-here"
    }
  }
}

Start with basic mode (7 tools). Advanced mode has 56 tools which can confuse the AI.

Usage in Cursor

With Cursor Composer

You: "Create tasks for building an authentication system"

Cursor AI: [Uses MCP to create multiple tasks in Forge]

Cursor AI: "I've created 5 tasks:
           - OAuth integration
           - JWT token generation
           - User session management
           - Password reset
           - Security audit

           Want me to start on any?"

With @ Commands

Access Forge tasks using @:

You: @automagik-forge "Show my pending tasks"

Cursor AI: [Lists tasks via MCP]

Troubleshooting

MCP server not found

Solutions:

Verify Forge is installed: npm list -g @automagik/forge
Check settings JSON syntax (no trailing commas)
Ensure "command": "npx" not "node"
Reload Cursor window (Cmd/Ctrl + R)

Project ID error

Error: Project not foundFix:

Open Forge UI: npx automagik-forge
Copy correct UUID from URL
Update projectId in Cursor settings
Reload Cursor

Tools not working

Check:

Ask Cursor: “What MCP servers do you have?”
Verify automagik-forge appears
If not, check config and reload

Configuration File Location

Cursor stores MCP config in:

macOS
Windows
Linux

~/Library/Application Support/Cursor/User/settings.json

%APPDATA%\Cursor\User\settings.json

~/.config/Cursor/User/settings.json

Getting Started

Learn

Configuration

Reference

Troubleshooting

Cursor MCP Setup

Prerequisites

Configuration

Option 1: Basic Mode (Recommended)

Option 2: Advanced Mode

Usage in Cursor

With Cursor Composer

With @ Commands

Troubleshooting

Configuration File Location

Next Steps

MCP Overview

MCP Tools

​Cursor MCP Setup

​Prerequisites

​Configuration

​Option 1: Basic Mode (Recommended)

​Option 2: Advanced Mode

​Usage in Cursor

​With Cursor Composer

​With @ Commands

​Troubleshooting

​Configuration File Location

​Next Steps

MCP Overview

MCP Tools

Cursor MCP Setup

Prerequisites

Configuration

Option 1: Basic Mode (Recommended)

Option 2: Advanced Mode

Usage in Cursor

With Cursor Composer

With @ Commands

Troubleshooting

Configuration File Location

Next Steps