ionic-framework-mcp — Ionic MCP server for Claude Code
Connect an AI coding agent to Ionic Framework documentation, component APIs, framework-specific examples, and blog posts. Useful when building or debugging Ionic interfaces.
MIT ★ 1 updated 2026-09-08
claude mcp add --transport http ionic-framework-mcp https://ionic-framework-mcp.capawesome.io/mcpWhat ionic-framework-mcp does
ionic-framework-mcp exposes Ionic Framework reference material through MCP tools. Use search_docs to find relevant documentation, then get_doc_page to retrieve a complete page. list_components searches the component catalog and API references, while get_component_usage provides examples tailored to a framework. The list_blog_posts tool retrieves entries from the Ionic blog.
The server covers Ionic Framework v9 and v8, with v9 selected by default. Component examples are available for Angular, React, Vue, and plain JavaScript. A hosted HTTP endpoint allows compatible clients to connect without running a local server package or supplying an access token. Clients that cannot use remote HTTP can run the npm package through npx, which requires Node.js 22 or later.
The service allows 100 requests per minute per IP address. Requests beyond that threshold receive 429 Too Many Requests and can be retried after a brief pause. Capawesome maintains the project; it is an unofficial integration and is not endorsed by Ionic or OutSystems.
What it helps with
- Locate Ionic documentation by component name or API keyword
- Retrieve a complete Ionic documentation page
- Check component references across Ionic Framework v8 and v9
- Find implementation examples for Angular, React, or Vue
- Browse posts published on the Ionic blog
Example prompts for the agent
- Find Ionic documentation showing how to use a button component in React.
- Look up this Ionic component's API in version v8 and explain its parameters.
- Find Ionic blog posts about interface components.
How to install ionic-framework-mcp
1Platform CLI: remote server
claude mcp add --transport http ionic-framework-mcp https://ionic-framework-mcp.capawesome.io/mcp2Platform CLI
claude mcp add ionic-framework-mcp -- npx -y @capawesome/ionic-framework-mcp1Platform CLI: remote server
codex mcp add ionic-framework-mcp --url https://ionic-framework-mcp.capawesome.io/mcp2Platform CLI
codex mcp add ionic-framework-mcp -- npx -y @capawesome/ionic-framework-mcpConfig file
{
"mcpServers": {
"ionic-framework-mcp": {
"url": "https://ionic-framework-mcp.capawesome.io/mcp"
}
}
}{
"mcpServers": {
"ionic-framework-mcp": {
"command": "npx",
"args": [
"-y",
"@capawesome/ionic-framework-mcp"
]
}
}
}Config file
{
"servers": {
"ionic-framework-mcp": {
"type": "http",
"url": "https://ionic-framework-mcp.capawesome.io/mcp"
}
}
}{
"servers": {
"ionic-framework-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@capawesome/ionic-framework-mcp"
]
}
}
}1Platform CLI: remote server
gemini mcp add -t http ionic-framework-mcp https://ionic-framework-mcp.capawesome.io/mcp2Platform CLI
gemini mcp add ionic-framework-mcp npx -y @capawesome/ionic-framework-mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about ionic-framework-mcp
How do I install ionic-framework-mcp in Claude Code?
To connect to the hosted endpoint, run claude mcp add --transport http ionic-framework-mcp https://ionic-framework-mcp.capawesome.io/mcp. To use the npm-based proxy instead, run claude mcp add ionic-framework-mcp -- npx -y @capawesome/ionic-framework-mcp. The package-based option requires Node.js 22 or later.
What does ionic-framework-mcp do?
It gives an AI agent MCP tools for searching Ionic documentation, retrieving full pages, exploring component APIs, and finding framework-specific usage examples. It also exposes Ionic blog posts.
Can ionic-framework-mcp access Ionic Framework v8 documentation?
Yes. Both v8 and v9 documentation are available. Version v9 is the default; pass the version parameter to request v8.