Skip to content

Add NeoReader to Claude Code

Claude Code can create dynamic QR codes, update where they go and read scan counts while you work in the terminal. It takes one command.

Developers › Claude Code

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 Claude Code 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.

Add the server and sign in

Run this in your terminal:

claude mcp add --transport http neoreader https://neoreader.com/mcp

Start Claude Code, type /mcp, choose neoreader and then Authenticate. Your browser opens NeoReader. Sign in, read what the assistant can and cannot do, and choose Allow. Claude Code keeps the approval and renews it when it is used.

Add --scope user to make the server available in every project, or --scope project to share it with your team through a .mcp.json file.

Use an API token instead

For scripts and servers where no browser is available, create a token under Account, then API Tokens, and pass it as a header:

claude mcp add --transport http neoreader https://neoreader.com/mcp \
  --header "Authorization: Bearer YOUR_TOKEN"

Try it

Disconnect

claude mcp remove neoreader

To end the approval on the NeoReader side, choose Disconnect under Connected Assistants on the API Tokens page of your account.

What Claude Code 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, Cursor and VS Code and GitHub Copilot. 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.