dashboard-icons
homarr-labs · homarr-labs/dashboard-icons
Search and retrieve over 3,400 icons and logos with CDN links via an MCP server for your AI coding agent.
3,400+ curated icons and logos for dashboards and AI agents. SVG, PNG and WEBP on a free CDN, plus an MCP server for Claude Code, Codex, ChatGPT, Cursor, Hermes and OpenClaw.
Preview
What you can do with it
- Ask Claude to find and insert the official logo for a service into your UI
- Automatically match icons for all services listed in a Docker Compose file
- Retrieve consistent SVG icons for a custom dashboard project
Safety check
No risky patterns found in the files we scanned.
Automated scan of the repo files. Always review code you run.
From the README
Dashboard Icons
Your definitive source for dashboard icons, for you and your AI agent.
A collection of over 3,400 curated icons and logos for services, applications and tools, designed for dashboards and app directories. Your agent can use them too: the MCP server lets Claude Code, Codex, ChatGPT, Cursor, Hermes, OpenClaw and other agents find the right icon and its CDN link.
→ Browse the collection at dashboardicons.com
Why Dashboard Icons?
- Comprehensive Collection: 3,400+ icons for all popular services and tools
- Consistent Style: Uniform visual language across different services
- Multiple Formats: Available in SVG, PNG, and WEBP to suit your needs
- Light & Dark Variants: Icons optimized for both light and dark themes
- Agent-Ready: An MCP server that matches a whole
docker-compose.ymlto icons in one call and also searches the selfh.st, LobeHub and Simple Icons catalogs - Community-Driven: Submit missing icons on dashboardicons.com/submit, or let your agent do it
https://github.com/user-attachments/assets/65d61e2c-c80d-4174-8d1a-4117336909e4
Using the Icons
Website
Find and download icons at dashboardicons.com:
- Search for the icon you need
- Click on an icon to view details
- Choose your preferred format
- Download or copy the direct link
Use it from your AI agent (MCP)
Give your coding agent or assistant direct access to the collection through the Model Context Protocol. It can then:
- Match every service in a
docker-compose.ymlor dashboard config to an icon in one call - Return CDN links for SVG, PNG and WEBP in light and dark, or the raw SVG to inline
- Search the selfh.st, LobeHub and Simple Icons catalogs as well, with their licenses
- Submit a missing icon or propose an update for you, once you sign in
The server is free and needs no API key: https://dashboardicons.com/api/mcp
| Agent | Setup |
|---|---|
| Claude Code | claude mcp add --transport http dashboard-icons https://dashboardicons.com/api/mcp |
| Codex | codex mcp add dashboard-icons --url https://dashboardicons.com/api/mcp |
| ChatGPT | On ChatGPT web: Plugins → + → Add custom MCP server, then paste the URL above. Workspace plans may need an admin to allow it |
| Cursor | Add "dashboard-icons": { "url": "https://dashboardicons.com/api/mcp" } under mcpServers in .cursor/mcp.json |
| VS Code | Add "dashboard-icons": { "type": "http", "url": "https://dashboardicons.com/api/mcp" } under servers in .vscode/mcp.json |
| Hermes Agent | Add dashboard-icons: { url: "https://dashboardicons.com/api/mcp" } under mcp_servers in ~/.hermes/config.yaml |
| OpenClaw | openclaw mcp add dashboard-icons --url https://dashboardicons.com/api/mcp --transport streamable-http |
| Other clients | Any client with Streamable HTTP support takes the URL. Stdio-only clients can use npx -y mcp-remote https://dashboardicons.com/api/mcp |
Then ask something like "Add icons for every service in my docker-compose.yml". You can also open Add to MCP client on dashboardicons.com for copy-paste setup. Tools, limits and sign-in are covered in the MCP documentation.
Direct Links
Use icons from CDN with this pattern:
<Base URL>/<Format>/<Icon Name>.<Format>
Base URL options:
- jsDelivr (recommended):
https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons - GitHub Direct:
https://raw.githubusercontent.com/homarr-labs/dashboard-icons/main
Example:
Technical Details
-
Naming Convention: Kebab-case (lowercase with hyphens)
- Example: "Nextcloud Calendar" →
nextcloud-calendar
- Example: "Nextcloud Calendar" →
-
Available Formats:
- SVG: Vector format (original source)
- PNG: 512px height (auto-generated)
- WEBP: 512px height (auto-generated)
-
Variants:
-lightsuffix for dark backgrounds (e.g.,github-light.svg)-darksuffix for light backgrounds (e.g.,github-dark.svg)
-
Command Line:
# Download with curl curl -O https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/svg/nextcloud.svg # Download with wget wget https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/svg/nextcloud.svg
Dashboard Integration
These icons integrate seamlessly with popular dashboard applications:
...and many others!
Contributing
Request Icons
Need an icon that's not in our collection?
[!NOTE] Submit new icons and updates to existing ones with the form at dashboardicons.com/submit. GitHub issues are no longer used for icon submissions.
[!IMPORTANT] If you would like to help review, approve, or reject icon submissions, contact us:
- Discord: https://discord.com/invite/aCsmEV5RgA
- Email: homarr-labs@proton.me
If you want to be an admin for dashboardicons.com, tell us (via Discord or email) why you'd like to help and what you bring to the project!
- Check the Contribution Guidelines for specifications
- Open dashboardicons.com/submit to add a new icon or propose an update