# Material Symbols — card for AI agents

Google's Apache-2.0 icon set, served as a variable icon font, with the official Google Design MCP.

Category: Icons · maker Google · checked 2026-11-09 · style: outline, filled

## Price
- Price: Free
- Free tier: Free.

## License
Apache-2.0 — https://github.com/google/material-design-icons

- commercial: **yes** (Commercial use OK)
  > We have made these icons available for you to incorporate into your products under the Apache License Version 2.0.
  (https://github.com/google/material-design-icons)
- attribution: **no** (No credit needed)
  > We'd love attribution in your app's about screen, but it's not required.
  (https://github.com/google/material-design-icons)
- in app: **yes** (Can ship inside your app)
  > We have made these icons available for you to incorporate into your products under the Apache License Version 2.0.
  (https://github.com/google/material-design-icons)
- redistribute: **yes** (Can pass the files on to your own users)
  > Feel free to remix and re-share these icons and documentation in your products.
  (https://raw.githubusercontent.com/google/material-design-icons/HEAD/README.md)

## Rules to follow
- Use Material Symbols; classic Material Icons are no longer updated.

## Can an AI agent use it by itself?
**Yes** · free-api: Agent calls a free official API or MCP

## How an agent gets files
- Google Fonts link (recommended), repo font/variablefont folders, community npm packages, or the Design MCP at https://design.googleapis.com/mcp (search_icons, icons_instructions). (sign-in: none)
- Formats: svg, variable font
- Not allowed: Material Icons (classic) is no longer updated; use Material Symbols
- Not allowed: Design MCP needs Google Cloud authentication; Google does not vet community npm packages

## How to connect
- Official MCP server
- MCP server (official): https://design.googleapis.com/mcp
- API docs: https://developers.google.com/design-mcp/reference/mcp
- Repository: https://github.com/google/material-design-icons
- Website: https://fonts.google.com/icons

## Notes
The Design MCP has search_icons and icons_instructions tools; Google's reference page says you must enable MCP servers and set up authentication before use. npm packages (material-symbols, material-icons, @material-design-icons/svg) are community; Google does not vet them.

## Numbers (AgentGid data)
- Gid Score: 52
- GitHub stars: 54,317

## Lines to paste into your prompt or AGENTS.md

```
- Material Symbols (Icons). Google's Apache-2.0 icon set, served as a variable icon font, with the official Google Design MCP. Price: free; commercial use OK; no credit needed. Style: outline, filled.
  Connect: official MCP server https://design.googleapis.com/mcp.
  Get files: Google Fonts link (recommended), repo font/variablefont folders, community npm packages, or the Design MCP at https://design.googleapis.com/mcp (search_icons, icons_instructions) (svg, variable font).
  Not allowed: Material Icons (classic) is no longer updated; use Material Symbols
  Not allowed: Design MCP needs Google Cloud authentication; Google does not vet community npm packages
  Rule: Use Material Symbols; classic Material Icons are no longer updated.
  License: https://github.com/google/material-design-icons (checked 2026-11-09; details: https://agentgid.com/assets/material-symbols/)
```

Not verified: Design MCP GA vs preview status not stated.

## Links
- AgentGid page: https://agentgid.com/assets/material-symbols/
- Is it free for commercial use? https://agentgid.com/assets/material-symbols/commercial-use/
- Source: https://github.com/google/material-design-icons
- Source: https://developers.google.com/design-mcp/reference/mcp


## Material Symbols: Google's free icons you can fine-tune

Material Symbols is Google's free set of icons, such as home, search or settings, all in one matching style. They come as a font, so you type an icon's name, like "home", and the page shows the icon. You can switch each icon between outline and filled, thin and bold, and three corner styles.

### Where to use it
- Menus and toolbars in a web app: Put icons in a sidebar, a top bar or buttons by typing their names. Loading only the icons you use keeps the page fast.
- Show what is selected: Fill the icon of the open tab in a bottom bar, or a heart once something is saved, while the others stay as outlines.
- Icons on a dark theme: Make icons slightly thinner on dark backgrounds so they do not glare, or bolder to stress one action, without changing their size.
- Android and iPhone apps and mockups: Use the same icons in a phone app and in design mockups, so the app, the website and the designs match.
- Icons served from your own site: Keep the icon font on your own server, for example for an internal tool, so you decide when it changes and visitors do not contact Google.
- Let an AI assistant pick icons: Google runs a free design service for AI assistants that turns words like "save" or "storage" into matching icon names.

### How to start
- Add one line to the page head to load the icon font from Google Fonts (add &icon_names=... to load only the icons you use).

```
<link href="https://fonts.googleapis.com/css2?family=Material+Symbols+Outlined" rel="stylesheet" />
```

- Put the icon name, with underscores instead of spaces, inside an element with the matching class.

```
<span class="material-symbols-outlined">arrow_forward</span>
```

- To host it yourself, take the font files from the variablefont folder of Google's repository and add the CSS rules from the guide.

### License
Free under the Apache License 2.0, also in paid apps, and you may change and re-share the icons. A visible credit is welcome but not required. Keep the license text with copies of the files you pass on.

### Good to know
- The full font carries every icon and every style and is heavy. List only the icons you use in the font link to keep the download small.
- The older Material Icons set gets no new icons; use Material Symbols for new work.
- There are no company logos such as social networks; Google removed the few it had.
- Google does not run the install packages for code projects; the ones people use are made by a community member and are not checked by Google.
- Only the 20 and 24 pixel sizes are drawn to sit exactly on the pixel grid; other sizes can look slightly soft.

Checked 2026-11-09 against: https://fonts.google.com/icons, https://developers.google.com/fonts/docs/material_symbols, https://github.com/google/material-design-icons, https://github.com/google/material-design-icons/blob/HEAD/README.md, https://github.com/google/material-design-icons/blob/master/LICENSE, https://developers.google.com/design-mcp, https://developers.google.com/design-mcp/overview, https://developers.google.com/design-mcp/reference/mcp, https://developers.google.com/design-mcp/reference/mcp/tools_list/search_icons, https://developers.google.com/design-mcp/reference/mcp/tools_list/icons_instructions, https://m3.material.io/styles/icons/overview, https://api.github.com/repos/google/material-design-icons/contents/variablefont

### Mistakes to avoid
- Don't: <link href="https://fonts.googleapis.com/css2?family=Material+Symbols+Outlined" rel="stylesheet" /> in production → Do: Add &icon_names= with the used names sorted A to Z, and &display=block (The plain link loads every icon; the guide lists 295 KB versus 1.7 KB for three icons.)
- Don't: <span class="material-icons">home</span> with the classic Material Icons font in a new project → Do: <span class="material-symbols-outlined">home</span> with Material Symbols (The classic set gets no new icons.)
- Don't: Writing icon names as "arrow forward" or "ArrowForward" → Do: arrow_forward (lower case with underscores) (The font only turns exact snake_case names into icons; anything else shows as text.)
- Don't: font-variation-settings: 'FILL' 1 on a page that loads the default static font → Do: Load the variable range (for example Material+Symbols+Outlined:FILL@0..1) or the self-hosted variable font (The default link is a static font with fill 0, so the fill setting has no effect.)
- Don't: npm install material-symbols as if it were Google's package → Do: Use Google Fonts or the font files from Google's repository; if you use the community package, pin its version (Google does not publish or check those packages.)

### Questions
- Can I use Material Symbols in a paid app? Yes. Google offers them under the Apache License 2.0 for use in your products; a credit is welcome but not required.
- What is the difference from Material Icons? Material Symbols is the current set from April 2022, built as an adjustable font. Material Icons is the classic set and gets no updates.
- Is there a filled version? Yes. There is no separate filled font; every style can be filled with the fill setting, from 0 (outline) to 1 (filled).
- Why do I briefly see words like "home" instead of icons? The text shows until the font loads. Add display=block to the font link, as the guide asks.
- Does it work in Flutter apps? Not yet; the guide says Flutter support is planned. Web, Android and iOS formats are available.

---
AgentGid's catalog is curated: every entry was checked against the maker's official pages (registry, repository, license and pricing pages) on the date shown; a license value shows the quote it stands on wherever AgentGid has one. Usage numbers come from AgentGid's own scan of public repositories set up for AI coding agents. Claims by makers are reported, not tested by AgentGid.
