English Français العربية

QRcodly

Official registry Other

Create, manage, and share QR codes and short URLs

Source code Website Documentation

What can you do with QRcodly?

  • Multiple QR code types — URL, vCard, Wi-Fi, Email, Calendar Event, Location, Plain Text
  • Full customization — colors, sizes, backgrounds, and custom icon uploads
  • Export formats — PNG, JPEG, SVG
  • URL shortening & analytics — shorten links and track scans
  • Templates — save and reuse QR code configurations
  • Custom domains — use your own domain for short URLs (Cloudflare integration)
  • Internationalization — 8 languages (EN, DE, ES, FR, IT, NL, PL, RU)
  • Authentication — powered by Clerk

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http qrcodly 'https://mcp.qrcodly.de/mcp' --header 'Authorization: <Bearer token for API authentication (format: Bearer <your-api-key>)>'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "qrcodly": {
            "type": "http",
            "url": "https://mcp.qrcodly.de/mcp",
            "headers": {
                "Authorization": "<Bearer token for API authentication (format: Bearer <your-api-key>)>"
            }
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. QRcodly
  2. Features
  3. Monorepo Structure
  4. Tech Stack
  5. Prerequisites
  6. Quick Start
  7. Available Scripts
  8. Local Services (Docker Compose)
  9. Contributing
  10. License

QRcodly

QRcodly is a free, open-source QR code generator and management platform. Create, customize, and track QR codes for URLs, contact details, Wi-Fi credentials, and more.

Features

  • Multiple QR code types — URL, vCard, Wi-Fi, Email, Calendar Event, Location, Plain Text
  • Full customization — colors, sizes, backgrounds, and custom icon uploads
  • Export formats — PNG, JPEG, SVG
  • URL shortening & analytics — shorten links and track scans
  • Templates — save and reuse QR code configurations
  • Custom domains — use your own domain for short URLs (Cloudflare integration)
  • Internationalization — 8 languages (EN, DE, ES, FR, IT, NL, PL, RU)
  • Authentication — powered by Clerk
  • Browser extension — generate QR codes from any page

Monorepo Structure

qrcodly/
├── apps/
│   ├── backend/            # Fastify REST API
│   ├── frontend/           # Next.js web application
│   └── browser-extension/  # Vite-based browser extension
├── packages/
│   ├── shared/             # Zod schemas, DTOs, and shared utilities
│   ├── eslint-config/      # Shared ESLint configuration
│   └── typescript-config/  # Shared TypeScript configuration
└── docker-compose.yaml     # Local development services

See per-app READMEs for architecture details: Backend · Frontend · Browser Extension · Shared Package

Tech Stack

LayerTechnologies
FrontendNext.js, React, TypeScript, Tailwind CSS, shadcn/ui, Zustand, TanStack Query, next-intl
BackendFastify, TypeScript, Drizzle ORM, tsyringe (DI), Zod, Nodemailer, Handlebars
DatabaseMySQL, Redis
StorageS3 / MinIO
AuthClerk
BillingStripe
AnalyticsUmami, PostHog
MonitoringAxiom, Sentry

Prerequisites

Quick Start

# 1. Clone the repository
git clone https://github.com/FloB95/qrcodly.git
cd qrcodly

# 2. Install dependencies
pnpm install

# 3. Start local services (MySQL, Redis, MinIO, Umami)
docker-compose up -d

# 4. Set up environment variables
cp apps/backend/.env.example apps/backend/.env
cp apps/frontend/.env.example apps/frontend/.env
# Edit both .env files with your configuration (Clerk keys, etc.)

# 5. Start development servers
pnpm run start:dev
# Backend API → http://localhost:5001
# Frontend   → http://localhost:3000

Available Scripts

ScriptDescription
pnpm run start:devStart backend and frontend in development mode
pnpm run backend:devStart backend only (runs migrations first)
pnpm run frontend:devStart frontend only
pnpm run buildBuild all apps
pnpm run build:shared-packageBuild the shared package only
pnpm run lintLint all workspaces
pnpm run formatFormat all files with Prettier
pnpm run cleanClean build artifacts across all apps

Local Services (Docker Compose)

ServicePortDetails
MySQL3306Credentials: root / root, database: qrcodly
Redis6379—
MinIO (S3)9000 (API), 9001 (Console)Credentials: minio / testtest
phpMyAdmin8081—
Umami Analytics3001—

Contributing

Contributions are welcome! Please see CONTRIBUTING.md for guidelines and setup instructions.

License

This project is licensed under the MIT License.

Frequently asked questions

What is QRcodly?

Create, manage, and share QR codes and short URLs

How do I install QRcodly?

It runs as a remote server. In Claude Code: claude mcp add --transport http qrcodly 'https://mcp.qrcodly.de/mcp' --header 'Authorization: <Bearer token for API authentication (format: Bearer <your-api-key>)>'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does QRcodly need an API key?

Yes. It expects Authorization, which you set in its configuration.

Is QRcodly open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains QRcodly?

It is published by FloB95. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.