Skip to main content

​
Cursor MCP Setup

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

​
Prerequisites

1

Install Forge

npm install -g automagik-forge
2

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

1

Open Cursor Settings

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

Search for MCP

Type “MCP” in the settings search box
3

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

Reload Window

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

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

Solutions:
  1. Verify Forge is installed: npm list -g automagik-forge
  2. Check settings JSON syntax (no trailing commas)
  3. Ensure "command": "npx" not "node"
  4. Reload Cursor window (Cmd/Ctrl + R)
Error: Project not foundFix:
  1. Open Forge UI: npx automagik-forge
  2. Copy correct UUID from URL
  3. Update projectId in Cursor settings
  4. Reload Cursor
Check:
  1. Ask Cursor: “What MCP servers do you have?”
  2. Verify automagik-forge appears
  3. If not, check config and reload

​
Configuration File Location

Cursor stores MCP config in:
  • macOS
  • Windows
  • Linux
~/Library/Application Support/Cursor/User/settings.json

​
Next Steps

MCP Overview

Learn about MCP integration

MCP Tools

See all available tools