AdYour product here, seen by people installing AI tools every day Sponsor slots open: 12 of 12, from $249 a month

How to install Headless in Cursor

To install Headless in Cursor, click "Add to Cursor" on this page or paste the "headless" block into ~/.cursor/mcp.json, then check for a green dot in Cursor Settings under MCP.

Built from the published package · server updated 2 days ago

  1. 1

    One click (fastest)

    Click the button to open Cursor with this server ready to add.

    Add Headless to Cursor
  2. 2

    Or add it by hand

    Open Cursor Settings, then MCP, then Add new MCP server, or edit mcp.json directly and paste:

    {
      "mcpServers": {
        "headless": {
          "command": "npx",
          "args": [
            "-y",
            "@bilig/headless"
          ]
        }
      }
    }
  3. 3

    Turn it on

    In Settings, MCP, make sure the server shows a green dot. Use it in Agent mode.

Config file: ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (this project)

MCP servers run with your permissions. If Headless needs an API key, add it under env in the config. Check its README.

Install Headless in another app

Similar servers

Questions

Does Headless work in Cursor?

Yes. Cursor supports local and remote mcp servers, and Headless installs with the steps above.

Headless does not show up in Cursor. What now?

Restart Cursor fully, check the JSON is valid, and make sure Node.js (for npx) is installed. See common MCP errors and fixes.

Is Headless safe?

It scores 92 of 100. Review the code before you install it, and only give it the access it needs. Grades and details.