Awesome Ionic MCP server

Your comprehensive Ionic coding companion powered by the Model Context Protocol (MCP). This intelligent server provides seamless access to Ionic Framework components, Capacitor plugins, developer resources, and CLI command execution to accelerate your mobile app development workflow. Whether you're building cross-platform applications with React, Angular, Vue, or Vanilla JavaScript, this MCP server delivers real-time component definitions, API documentation, code examples, plugin information, and the ability to execute Ionic/Capacitor CLI commands directly to your AI assistant, enabling faster development and better code quality.

Data is sourced from the package @ionic/core, ionicframework.com, docs-demo.ionic.io, capacitorjs.com, capawesome.io, capacitor-community, and capgo.live to ensure accuracy and completeness.

Tools available

| Tool Name | Feature Group | Description | | --------- | ------------- | ----------- | | get_ionic_component_definition | @ionic/core.json | Retrieves the typescript definition of an Ionic component based on its HTML tag. | | get_all_ionic_components | @ionic/core.json | Retrieves the list of all Ionic components available for this tool | | get_component_api | ionicframework.com | Retrieves the component API on from the IonicFramework page using its HTML tag. | | get_component_demo | docs-demo.ionic.io | Returns the component demo from the GitHub repository based on its HTML tag. | | get_official_plugin_api | capacitorjs.com | Retrieves the official plugin API on from the Capacitor page using its HTML tag. | | get_all_official_plugins | capacitorjs.com | Retrieves list of all Official Capacitor plugins. | | get_all_plugins | capawesome.io | Retrieves list of all Capawesome Capacitor plugins (free and insider versions). | | get_all_free_plugins | capawesome.io | Retrieves list of all Capawesome Capacitor free plugins - intensively curated and up-to-date. | | get_all_insider_plugins | capawesome.io | Retrieves list of all Capawesome Capacitor insider plugins - intensively curated and up-to-date. | | get_plugin_api | capawesome.io | Retrieves API documentation for a specific Capawesome Capacitor plugin. | | get_capacitor_community_plugin_api | capacitor-community | Retrieves API documentation for a specific Capacitor Community plugin. | | get_all_capacitor_community_plugins | capacitor-community | Retrieves list of all Capacitor Community plugins. | | get_capgo_plugin_api | capgo | Retrieves API documentation for a specific CapGo plugin. | | get_all_capgo_plugins | capgo | Retrieves list of all CapGo plugins. | | get_all_capacitor_plugins | all-capacitor-plugins | Superlist of all Capacitor plugings from different publishers you can use to retrieve API information through this MCP tool. If you are lost about which plugin to use, this tool will help you find the right one. | | ionic_info | ionic-cli | Get comprehensive project, system, and environment information | | ionic_config_get | ionic-cli | Read CLI or project configuration values | | ionic_config_set | ionic-cli | Set CLI or project configuration value | | ionic_config_unset | ionic-cli | Delete/unset configuration value | | ionic_start | ionic-cli | Create a new Ionic project | | ionic_start_list | ionic-cli | List available Ionic starter templates | | ionic_init | ionic-cli | Initialize existing project with Ionic | | ionic_build | ionic-cli | Build web assets for deployment | | ionic_serve | ionic-cli | Start local development server | | ionic_generate | ionic-cli | Generate pages, components, services | | ionic_repair | ionic-cli | Repair project dependencies | | integrations_list | ionic-cli | List project integrations | | integrations_enable | ionic-cli | Enable integration in project | | integrations_disable | ionic-cli | Disable integration in project | | capacitor_doctor | ionic-cli | Check Capacitor setup for errors | | capacitor_list_plugins | ionic-cli | List installed Capacitor plugins | | capacitor_sync | ionic-cli | Sync web assets and dependencies | | capacitor_copy | ionic-cli | Copy web assets to native platforms | | capacitor_update | ionic-cli | Update native dependencies | | capacitor_init | ionic-cli | Initialize Capacitor configuration | | capacitor_add | ionic-cli | Add native platform (iOS/Android) | | capacitor_build | ionic-cli | Build native platform release | | capacitor_run | ionic-cli | Run app on device/emulator | | capacitor_open | ionic-cli | Open native IDE | | capacitor_migrate | ionic-cli | Migrate to latest Capacitor version |

CLI Tools

The Awesome Ionic MCP server now includes 28 Ionic and Capacitor CLI tools that allow you to execute commands directly through your AI assistant:

Project Information & Diagnostics

• ionic_info - Get project, system, and environment information
• capacitor_doctor - Check setup for configuration errors
• capacitor_list_plugins - List all installed plugins
• ionic_config_get/set/unset - Manage configuration values
• integrations_list - List available integrations

Development Workflow

• ionic_build - Build web assets with optimizations
• ionic_serve - Start development server (manual launch recommended)
• capacitor_sync - Sync web assets and update native dependencies
• capacitor_copy - Copy web assets to native platforms
• capacitor_update - Update native plugins

Code Generation

• ionic_generate - Generate pages, components, services, guards, pipes
• Framework-specific scaffolding for Angular, React, Vue

Project Setup & Management

• ionic_start - Create new Ionic project
• ionic_start_list - List available templates
• ionic_init - Initialize existing project with Ionic
• capacitor_init - Initialize Capacitor configuration
• capacitor_add - Add iOS or Android platform
• integrations_enable/disable - Manage project integrations

Native Development

• capacitor_build - Build native app release
• capacitor_run - Run on device or emulator
• capacitor_open - Open Xcode or Android Studio
• capacitor_migrate - Migrate to latest Capacitor version

Maintenance

• ionic_repair - Fix dependencies and regenerate files

Common Workflows

Create a new project:

// 1. Create project
ionic_start({ name: "MyApp", template: "tabs", type: "react", capacitor: true })

// 2. Add iOS platform
capacitor_add({ project_directory: "./MyApp", platform: "ios" })

// 3. Build and sync
ionic_build({ project_directory: "./MyApp", prod: true })
capacitor_sync({ project_directory: "./MyApp", platform: "ios" })

Check project health:

ionic_info({ format: "json" })
capacitor_doctor({ platform: "ios" })
capacitor_list_plugins({})

Generate components:

ionic_generate({ type: "page", name: "home" })
ionic_generate({ type: "component", name: "user-card" })
ionic_generate({ type: "service", name: "auth" })

Getting started & upfront warning

The Awesome Ionic MCP server can work with any MCP client that supports standard I/O (stdio) as the transport medium. Here are specific instructions for some popular tools:

Just to let you know - for some data the MCP server will run Puppeteer to open a browser and get the data. So you will see a browser window spanwed and closed.

Basic configuration

Claude Desktop

To configure Claude Desktop to use the Awesome Ionic MCP server, edit the claude_desktop_config.json file. You can open or create this file from the Claude > Settings menu. Select the Developer tab, then click Edit Config.

{
  "mcpServers": {
    "awesome-ionic-mcp": {
      "command": "npx",
      "args": ["-y", "awesome-ionic-mcp@latest"]
    }
  }
}

Cline

To configure Cline to use the Awesome Ionic MCP server, edit the cline_mcp_settings.json file. You can open or create this file by clicking the MCP Servers icon at the top of the Cline pane, then clicking the Configure MCP Servers button.

{
  "mcpServers": {
    "awesome-ionic-mcp": {
      "command": "npx",
      "args": ["-y", "awesome-ionic-mcp@latest"],
      "disabled": false
    }
  }
}

Cursor

To configure Cursor to use the Awesome Ionic MCP server, edit either the file .cursor/mcp.json (to configure only a specific project) or the file ~/.cursor/mcp.json (to make the MCP server available in all projects):

{
  "mcpServers": {
    "awesome-ionic-mcp": {
      "command": "npx",
      "args": ["-y", "awesome-ionic-mcp@latest"]
    }
  }
}

Environment Variables

The server supports optional environment variables for enhanced functionality:

GITHUB_TOKEN (Recommended)

Purpose: Authenticate GitHub API requests to avoid rate limiting

Why it's needed: The server fetches plugin data from GitHub organizations (CapGo, Capacitor Community). Without authentication, GitHub limits you to 60 API requests per hour per IP address. The server makes ~160+ API calls during initialization, which exhausts the unauthenticated limit in a single startup. With a token, the limit increases to 5,000 requests per hour.

How to get a token:

1. Go to GitHub Settings → Developer settings → Personal access tokens → Tokens (classic)
2. Click "Generate new token (classic)"
3. Give it a descriptive name (e.g., "Awesome Ionic MCP")
4. No special scopes/permissions needed for public repository access
5. Copy the generated token (starts with ghp_)

Configuration example:

{
  "mcpServers": {
    "awesome-ionic-mcp": {
      "command": "npx",
      "args": ["-y", "awesome-ionic-mcp@latest"],
      "env": {
        "GITHUB_TOKEN": "ghp_your_token_here"
      }
    }
  }
}

MCP_QUIET

Purpose: Suppress informational logs (only errors will be shown)

When to use: If you want minimal logging output

Configuration example:

{
  "mcpServers": {
    "awesome-ionic-mcp": {
      "command": "npx",
      "args": ["-y", "awesome-ionic-mcp@latest"],
      "env": {
        "MCP_QUIET": "true"
      }
    }
  }
}

Visual Studio Code Copilot

To configure a single project, edit the .vscode/mcp.json file in your workspace:

{
  "servers": {
    "awesome-ionic-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "awesome-ionic-mcp@latest"]
    }
  }
}

To make the server available in every project you open, edit your user settings:

{
  "mcp": {
    "servers": {
      "awesome-ionic-mcp": {
        "type": "stdio",
        "command": "npx",
        "args": ["-y", "awesome-ionic-mcp@latest"]
      }
    }
  }
}

Windsurf Editor

To configure Windsurf Editor, edit the file ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "awesome-ionic-mcp": {
      "command": "npx",
      "args": ["-y", "awesome-ionic-mcp@latest"]
    }
  }
}

Credits

Credits go to Firebase team- for using their code of their Firebase MCP server. https://firebase.google.com/docs/cli/mcp-server