Skip to content

Add NeoReader to Cursor

Cursor can create dynamic QR codes, update their destinations and read scan counts through the NeoReader MCP server. Sign in with OAuth, or send an API token in a header.

Developers › Cursor

What you can do with it

NeoReader is a QR code generator for dynamic codes: the code holds a short link, neoreader.com/q/SLUG, that redirects to a destination you can change at any time, so a printed code never has to be replaced. The connector is free for members and gives Cursor these tools:

ToolWhat it does
create_codeMakes a dynamic QR code from a title and a destination, or a hosted page (PDF, business card, link list, menu, coupon, event, social media, feedback, location, app, image gallery or video) from a type and its content.
list_codesFinds your codes by search word, folder or status.
update_codeChanges the destination, page content, title, folder, expiry or on/off state.
get_code_statsReads scans by day, country, device, system and browser.
pause_codeStops a code redirecting without deleting it.
delete_codeDeletes a code for good. Only on your say-so.

Option one: sign in with OAuth

Add this to ~/.cursor/mcp.json for every project, or to .cursor/mcp.json inside one project:

{
  "mcpServers": {
    "neoreader": {
      "url": "https://neoreader.com/mcp"
    }
  }
}

Open Cursor Settings, then MCP. NeoReader shows as needing sign-in. Choose Connect, sign in to NeoReader in the browser window, and choose Allow.

Option two: use an API token

A token is handy for a shared machine or a script. In NeoReader, open Account, then API Tokens, choose Create Token and copy it. Then use:

{
  "mcpServers": {
    "neoreader": {
      "url": "https://neoreader.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}

Replace YOUR_TOKEN with your token. Keep the file out of public repositories, because anyone who has the token can manage your codes.

Try it

In the chat panel, ask:

Disconnect

Remove the neoreader entry from mcp.json. To end an OAuth approval, choose Disconnect under Connected Assistants on the NeoReader API Tokens page. To end a token, choose Revoke next to it.

What Cursor can and cannot do

When you connect, NeoReader shows a screen that lists this before you choose Allow. The assistant can create, read, change, pause and delete your dynamic QR codes and read their scan statistics. It cannot see or change your email address, sign-in or account settings, cannot see your API tokens, and cannot go past your account’s code limit. Scans are counted without storing IP addresses. Every action runs as you, so a code that belongs to someone else looks like a code that does not exist.

Troubleshooting

Other ways to connect

The same server works with Claude, ChatGPT, VS Code and GitHub Copilot and Claude Code. If you are writing your own code, use the QR code API and the OpenAPI description. To design the image of a code, use the QR code generator.