# ionic-framework-mcp

Connect an AI coding agent to Ionic Framework documentation, component APIs, framework-specific examples, and blog posts. Useful when building or debugging Ionic interfaces.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 1 repo stars
- Author: capawesome-team
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/capawesome-team/ionic-framework-mcp
- Updated: 2026-09-08
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/ionic-framework-mcp

## What it 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.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://ionic-framework-mcp.capawesome.io/mcp`

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http ionic-framework-mcp https://ionic-framework-mcp.capawesome.io/mcp
```

2. **Platform CLI**
```bash
claude mcp add ionic-framework-mcp -- npx -y @capawesome/ionic-framework-mcp
```

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add ionic-framework-mcp --url https://ionic-framework-mcp.capawesome.io/mcp
```

2. **Platform CLI**
```bash
codex mcp add ionic-framework-mcp -- npx -y @capawesome/ionic-framework-mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "ionic-framework-mcp": {
            "url": "https://ionic-framework-mcp.capawesome.io/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "ionic-framework-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@capawesome/ionic-framework-mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "ionic-framework-mcp": {
            "type": "http",
            "url": "https://ionic-framework-mcp.capawesome.io/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "ionic-framework-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@capawesome/ionic-framework-mcp"
            ]
        }
    }
}
```

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http ionic-framework-mcp https://ionic-framework-mcp.capawesome.io/mcp
```

2. **Platform CLI**
```bash
gemini mcp add ionic-framework-mcp npx -y @capawesome/ionic-framework-mcp
```

## When to use it
- 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
- 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.

## Similar
- [ionic-expert](https://affpapa.org/en/nevibecode/skills/ionic-expert.md) — skill · 1800 installs
- [ionic-app-creation](https://affpapa.org/en/nevibecode/skills/ionic-app-creation.md) — skill · 1300 installs
- [ionic-design](https://affpapa.org/en/nevibecode/skills/ionic-design.md) — skill · 1700 installs
- [ionic](https://affpapa.org/en/nevibecode/skills/ionic.md) — skill · 839 installs
- [ionic-enterprise-sdk-migration](https://affpapa.org/en/nevibecode/skills/ionic-enterprise-sdk-migration.md) — skill · 737 installs
- [comark](https://affpapa.org/en/nevibecode/skills/comark.md) — skill · 306 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
