material-icons-agent-skill
Provides tools for searching, importing, and managing Google Material Symbols in Android Compose and Android Views projects, including migration and auditing.
Provides tools for searching, importing, and managing Google Material Symbols in Flutter projects.
Provides tools for searching, importing, and managing Google Material Symbols in React and Web projects.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@material-icons-agent-skill search for a rounded save icon"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Material Icons Agent Skill
One icon workflow for every AI coding agent.
Search, import, migrate, validate, and maintain official Google Material Symbolsacross Codex · Claude · Gemini · Antigravity · Cursor · Grok
Quick start · Documentation · Русский · MCP tools
Version 0.1.0 — The kit is local-first: it uses official Google sources, does not overwrite assets by default, and requires explicit confirmation for destructive changes.
🔭 How it works
💬 User request
↓
🧠 Agent Skill ──── understands intent, platform, style, states, accessibility
↓
🔧 MCP + CLI ────── searches, imports, previews, migrates, audits, validates
↓
📦 Project ───────── Android Compose · Android Views · Flutter · Web · React · VueRelated MCP server: brain-mcp-icon-visual
⚡ Quick start
git clone <repository-url> material-icons-agent-skill
cd material-icons-agent-skill
npm install
npm run setupStart a new agent chat after setup. For Claude App / Desktop / Cowork, upload the generated material-icons-claude-skill.zip in Customize → Skills → Create skill → Upload a skill.
🚀 Choose your entry point
Use $material-icons: choose a rounded save icon for an article and add it to my Android Views screen.The agent reads the portable skill, detects your project environment, searches for the best icon, and imports it — all in one request.
npm run cli -- search "save article" --style rounded
npm run cli -- migrate-compose --root C:\path\to\project
npm run cli -- skill:updatenpm startThe server exposes search, import, preview, audit, environment detection, Compose migration, accessibility validation, optional wrappers, and an optional offline catalog.
See the full MCP reference →
🧩 Command palette
Goal | Command |
📥 Install into detected clients |
|
🔄 Refresh integrations after an update |
|
🗑️ Remove integrations |
|
⌨️ Run the CLI |
|
✅ Run syntax checks |
|
Run a command for one host:npm run setup -- --hosts Cursor
Remove only one: npm run skill:remove -- --hosts Cursor
For global access in Cursor, ChatGPT, and Claude Desktop → set up a global MCP server.
📚 Documentation
🗂️ Repository map
skills/material-icons/ 🧠 Portable skill and deterministic helpers
src/ 🔧 MCP server and CLI
integrations/ 🔌 MCP and host templates
templates/ 🏗️ Opt-in CI template
docs/ 📚 English + Russian documentation👤 Developer
Built and maintained by ByteFlipper (GitHub · Website · Telegram).
This project is intentionally local-first: the skill is portable, the MCP server runs over stdio, and destructive operations require explicit confirmation. See SECURITY.md for the operational boundaries.
📄 License
The kit is licensed under MIT. Google Material Symbols are provided separately under Apache-2.0; see google/material-design-icons.
Available Tools
11 toolsaudit_iconsC
Find duplicate and likely unused local Android/Flutter icon assets.
Inputs: root (required).
delete_iconC
Delete a computed local icon path. Requires explicit confirmation.
Inputs: name (required), root (required), target (required), confirm (required).
detect_project_environmentB
Detect Android Compose, Android Views, Flutter, and web evidence in a project.
Inputs: root (required).
generate_icon_wrappersB
OPTIONAL: generate Kotlin, Dart, or TypeScript icon constants. Enable this only in projects that want an AppIcons abstraction.
Inputs: root (required), names (required), output (required), target (required).
import_iconC
Download an official icon into Android, Flutter, or SVG project assets. Never overwrites files.
Inputs: name (required), root (required), target (required), style, +1 more.
migrate_compose_iconsB
Dry-run or apply standard Compose Icons.* to local painterResource replacements. Import drawables first; complex expressions are reported, never guessed.
Inputs: root (required), apply.
preview_iconsB
Create a local HTML preview sheet for a shortlist of icons.
Inputs: names (required), style, output.
search_iconsC
Search official Material Symbols by meaning and style.
Inputs: query (required), limit, style.
sync_offline_catalogC
OPTIONAL: write a project-local catalog of official icon names for offline or repeat lookup.
Inputs: root (required), refresh.
update_iconC
Explicitly re-download and replace an already imported local icon.
Inputs: name (required), root (required), target (required), confirm (required), +1 more.
validate_icon_usageC
Report likely missing accessibility labels for icon usage.
Inputs: root (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 11 tools
Each tool targets a distinct operation: searching, importing, updating, deleting, auditing, validating, migrating, generating wrappers, syncing offline catalog, previewing, and detecting environment. Even similar tools like audit_icons and validate_icon_usage are clearly separated by their focus (duplicates/unused vs accessibility labels).
All tool names follow a consistent verb_noun pattern in snake_case. Singular nouns are used for single-item operations (import_icon, delete_icon) and plural nouns for multi-item operations (search_icons, preview_icons), demonstrating a clear and predictable semantic convention.
11 tools is well within the ideal range for a specialized icon management skill. Each tool serves a distinct purpose in the workflow, and none are redundant or extraneous, making the set well-scoped for its domain.
The tool surface covers the full lifecycle of icon management: search, import, update, delete, audit, validate, migrate, generate wrappers, offline catalog, preview, and environment detection. There are no obvious gaps or dead ends for the stated purpose of managing Material Icons in projects.
Maintenance
Related MCP Connectors
Multilingual semantic SVG icon search with previews for AI coding agents. 20,000+ icons.
Icons for agentic development: search & fetch 366,000+ open-source icons as SVG/PNG. No API key.
A coding agent searches the Icons8 library by keyword and style, then adds the selected icon or illustration to the project. Icons8 draws all of it: 420,000+ icons (130+ styles) and 110,000+ illustrations (340+ styles), so one project doesn't end up with mixed looks. The server lives at https://mcp.icons8.com/mcp/ and signs people in through their Icons8 account in the browser. Downloading PNG is free as long as the project links back to Icons8. SVG is on the paid plan, and that plan makes the link optional.
Search open SVG icon packs and fetch exact SVG markup from coding agents through MCP.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceProvides access to over 200,000 icons from 150+ collections with features for searching, recommendations, and direct file synchronization. It supports multiple frameworks and optimizes AI performance by writing icon code directly to project files.1,352 npm1,471MIT
- FlicenseNot gradedqualityDmaintenanceVisual icon search, retrieval, and comparison for AI agents. Search 200k+ icons semantically, render side-by-side comparison grids, and retrieve raw SVG markup — all tools return images so vision-capable LLMs can see the icons.1-

Svg/icons MCPofficial
AlicenseNot gradedqualityCmaintenanceEnables AI coding tools to search, inspect, recommend, and export SVG icons from svgicons.com for use in design systems, frontend projects, and AI-assisted workflows.MIT- AlicenseAqualityDmaintenanceProvides AI agents with tools to access Material 3 design components, design tokens, icons, and accessibility guidelines across multiple frameworks.868 npm6MIT