capacitor-mcp
Model Context Protocol (MCP) tools for Capacitor mobile development. Covers Ionic/Capacitor component APIs, plugin documentation, CLI commands, and AI-assisted development via MCP. Use this skill when users want to integrate AI agents with Ionic/Capacitor tooling.
By cap-go · 783 installs
npx skills add cap-go/capgo-skills --skill capacitor-mcp
Source repository · Upstream listing
Capacitor MCP Tools
Guide to using Model Context Protocol (MCP) for Ionic and Capacitor mobile development automation.
When to Use This Skill
User wants to automate Ionic/Capacitor development
User asks about MCP integration
User wants AI assisted component/plugin discovery
User needs programmatic CLI command execution
User wants access to Ionic components and Capacitor plugins within AI chat
What is MCP?
MCP (Model Context Protocol) is an open standard for connecting AI models to external tools and data sources. For Capacitor development, MCP enables:
Access to Ionic component definitions and APIs
Capacitor plugin documentation lookup
Automated CLI command execution (build, sync, run, etc.)
Project configuration management
Real time component demos and examples
Setting Up MCP for Capacitor
1. Install Awesome Ionic MCP Server
The awesome ionic mcp server is a comprehensive tool that provides access to:
Ionic Framework component APIs
Official Capacitor plugins
Capawesome plugins (free and insider)
Capacitor Community plugins
CapGo plugins
28 Ionic/Capacitor CLI commands
Claude Desktop
Add to claude desktop config.json (accessible via Claude Settings Developer):
Cline
Add to cline mcp settings.json :
Cursor
Add to .cursor/mcp.json (project specific) or ~/.cursor/mcp.json (global):
2. Optional: GitHub Token for Rate Limiting
The server makes ~160+ GitHub API calls during initialization to fetch plugin data. Without authentication, GitHub limits you to 60 requests/hour. With a token, this increases to 5,000 requests/hour.
Add GITHUB TOKEN to your MCP configuration:
Get a token from GitHub Settings → Developer settings → Personal access tokens. No special permissions needed for public repos.
Available MCP Tools
Ionic Component Tools
Capacitor Plugin Tools
Ionic CLI Commands
All commands accept a project directory parameter (defaults to current directory).
Project Information
Project Setup
Build & Serve
Code Generation
Integrations
Capacitor CLI Commands
Project Management
Build & Sync
Run & Deploy
Common Workflows
Create New Project
Check Project Health
Generate Code
AI Assisted Development Benefits
With awesome ionic mcp, AI assistants can:
1. Discover Components : Ask "What Ionic components can I use for forms?" and get accurate API docs
2. Find Plugins : Ask "Is there a Capacitor plugin for biometric authentication?" and get relevant results
3. Execute Commands : Request "Build the iOS app" and the CLI command runs automatically
4. Generate Code : Get component examples with proper TypeScript definitions
5. Troubleshoot : Look up plugin APIs and configuration without leaving the chat
Example Queries
With the MCP server installed, you can ask your AI assistant:
"Show me the API for ion modal component"
"List all available Capacitor Camera plugin methods"
"Generate a new page called settings"
"What Capawesome plugins are available for Firebase?"
"Build my app for iOS"
"Sync my Capacitor project"
"What are all the free CapGo plugins?"
Technical Details
Data Sources
The awesome ionic mcp server aggregates data from:
@ionic/core package (TypeScript definitions)
ionicframework.com (component API docs)
docs demo.ionic.io (component demos)
capacitorjs.com (official plugins)
capawesome.io (Capawesome plugins)
capacitor community (community plugins)
capgo.app (CapGo plugins)
Requirements
Node.js (for npx command)
Optional: GitHub token for avoiding API rate limits
Ionic/Capacitor project (for CLI commands)
Browser Automation
The server uses Puppeteer to fetch some documentation. You may see a browser window spawn and close during initialization this is normal.
Resources
awesome ionic mcp: https://github.com/Tommertom/awesome ionic mcp
MCP Specification: https://modelcontextprotocol.io
MCP SDK: https://github.com/modelcontextprotocol/sdk
Ionic Framework: https://ionicframework.com
Capacitor: https://capacitorjs.com
Capawesome Plugins: https://capawesome.io
CapGo Plugins: https://capgo.app