capacitor-mcp
Guides the agent through connecting an MCP client to the hosted, unofficial Capacitor MCP server by Capawesome, which serves the official Capacitor documentation for v8, v7, v6 and next, the official and community plugin list, and the Capacitor posts from the Ionic blog. Covers client detection, setup for Claude Code, Claude Desktop, Cursor, VS Code, Windsurf, Zed and stdio-only clients, documentation version selection, verification, and troubleshooting. Do not use for installing or configuring Capacitor plugins, upgrading or migrating apps and plugins to a newer version, Ionic Framework UI components, Capawesome Cloud, or MCP servers other than the Capacitor one.
- Installs
- 466
- Last 24h
- +107
- Trending rank
- #1915
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/capawesome-team/skills --skill capacitor-mcp- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads capacitor-mcp automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
Capacitor MCP Server
Connect an MCP client to the hosted Capacitor MCP server for the current Capacitor documentation, the official and community plugin list, and the Capacitor posts from the Ionic blog.
The server is hosted by Capawesome — there is nothing to install, no account, and no token:
https://capacitor-mcp.capawesome.io/mcp
This is an unofficial server. It is maintained by Capawesome and is not affiliated with or endorsed by Ionic or OutSystems. It serves the official Capacitor documentation, © the Ionic team and licensed under Apache-2.0.
Prerequisites
- An MCP client: Claude Code, Claude Desktop, Cursor, VS Code, Windsurf, Zed, or any other client that implements the Model Context Protocol.
- Network access to
https://capacitor-mcp.capawesome.io. - For clients that only start local commands: Node.js 22 or later.
Agent Behavior
- Guide step-by-step. Walk the user through the process one step at a time. Never present multiple unrelated questions at once.
- Auto-detect before asking. Detect the MCP client from the project before asking the user which one they use.
- Never ask for credentials. The server needs no account and no token. Never prompt for one and never write an
Authorizationheader into the configuration. - Pass the matching documentation version. Read
@capacitor/corefrompackage.jsonand pass the matchingversionon every call. See Documentation Versions.
Procedures
Step 1: Detect the MCP Client
Detect the client instead of asking, by checking the project root in this order:
.mcp.jsonor.claude/→ Claude Code.cursor/mcp.jsonor.cursor/→ Cursor.vscode/mcp.jsonor.vscode/→ VS Code
If none of these exist, or if more than one matches, ask the user which client to configure. Claude Desktop, Windsurf, and Zed keep their configuration outside the project, so they cannot be detected this way.
Step 2: Add the Server
Read references/client-setup.md and apply the section for the detected client. Register the server under the name capacitor.
Step 3: Restart the Client and Verify
- Tell the user to restart their MCP client so it picks up the new server.
- Verify the server by asking the client to run
search_docswith a query such aslive reload. - If the call fails, go to Error Handling.
Step 4: Use the Server
Once connected, prefer these tools over model knowledge and over reference files bundled with other skills whenever the topic is Capacitor itself — the CLI, the capacitor.config file, the native Android and iOS projects, an official plugin API, or upgrading to a newer major version.
| Tool | Parameters | Use for |
|---|---|---|
search_docs | query (required), section, version, limit | Finding the page that covers a topic. Start here. |
get_doc_page | url (required), version | Reading a full page as Markdown, using a URL from search_docs. |
list_plugins | query, source, limit | Finding a plugin for a native capability. |
list_blog_posts | — | Recent Capacitor posts from the Ionic blog, for announcements and release notes. |
Apply these rules:
- Read the whole page before writing code. Search snippets are deliberately short and regularly omit required configuration steps.
- Narrow with
sectionwhen the question belongs to one part of the documentation:getting-started,basics,guides,android,ios,web,plugins,apis,cli,reference,updating, orcordova. - Pass
sourcetolist_pluginsasofficial,community, orall(the default). Results are ranked official plugins first, then plugins maintained by Capawesome, then the remaining community plugins. The server discloses that ranking in its response, so weigh the order instead of treating it as neutral relevance. - Route other topics elsewhere. Capawesome plugins and Capawesome Cloud belong to the Capawesome MCP server; Ionic Framework UI components belong to the Ionic Framework MCP server. See Related Skills.
Documentation Versions
The documentation is available for v8 (the default), v7, v6, and next (the unreleased version).
Read the @capacitor/core version from package.json and map it:
@capacitor/core | version |
|---|---|
8.x | v8 |
7.x | v7 |
6.x | v6 |
| A pre-release of the next major | next |
Pass it on every search_docs and get_doc_page call. Without it the server answers for v8, which documents APIs and CLI flags an older release does not have. list_plugins and list_blog_posts take no version.
Error Handling
- Server not listed after setup: The client was not restarted. Restart it. In Claude Code, run
claude mcp listto confirm the server is registered. 429 Too Many Requests: The endpoint allows 100 requests per minute per IP. Retry after a short wait.- The client cannot reach a remote server: It only starts local commands. Use the
@capawesome/capacitor-mcpstdio proxy as shown inreferences/client-setup.md. It requires Node.js 22 or later. - A search returns no results: The index matches whole words, so a two-word guess such as
file systemmissesfilesystem. Retry with fewer, more general keywords, or with the exact package name. - A tool reports that the index is being built: The server rebuilds its index daily. Retry after a short wait.
- Answers mention APIs the project does not have: The
versionparameter was omitted or wrong. See Documentation Versions.
Related Skills
ionic-framework-mcp— For the Ionic Framework MCP server, which covers the UI components this server does not.capawesome-mcp— For the Capawesome MCP server, which covers the Capawesome plugins, the Capawesome CLI, and Capawesome Cloud.capacitor-app-development— For general Capacitor app development.capacitor-plugins— For installing and configuring the plugins this server lists.capacitor-expert— For a broad Capacitor reference covering plugins, framework integration, and Capawesome Cloud.
FAQ
What does the capacitor-mcp skill do?
Guides the agent through connecting an MCP client to the hosted, unofficial Capacitor MCP server by Capawesome, which serves the official Capacitor documentation for v8, v7, v6 and next, the official and community plugin list, and the Capacitor posts from the Ionic blog. Covers client detection, setup for Claude Code, Claude Desktop, Cursor, VS Code, Windsurf, Zed and stdio-only clients, documentation version selection, verification, and troubleshooting. Do not use for installing or configuring Capacitor plugins, upgrading or migrating apps and plugins to a newer version, Ionic Framework UI components, Capawesome Cloud, or MCP servers other than the Capacitor one.
How do I install capacitor-mcp?
Run npx skills add https://github.com/capawesome-team/skills --skill capacitor-mcp in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/capacitor-mcp/ (personal) or .claude/skills/capacitor-mcp/ (project).
Which AI agents can use capacitor-mcp?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is capacitor-mcp safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains capacitor-mcp?
It is published by capawesome-team in capawesome-team/skills. It has 466 recorded installs.
More from capawesome-team/skills
capacitor-plugins
capawesome-team/skills
Guides the agent through installing, configuring, and using Capacitor plugins from six sources — official Capacitor plugins, Capawesome plugins, Capacitor Community plugins, Capacitor Firebase plugins, Capacitor MLKit plugins, and RevenueCat plugins. Covers installation, platform-specific configuration (Android and iOS), and basic usage examples. Do not use for migrating Capacitor apps or plugins to a newer version, setting up Capacitor Live Updates, or non-Capacitor mobile frameworks.
ionic-angular
capawesome-team/skills
Guides the agent through Angular-specific patterns for Ionic app development. Covers project structure, standalone vs NgModule architecture detection, Angular Router integration with Ionic navigation (tabs, side menu, modals), lazy loading, Ionic page lifecycle hooks, reactive forms with Ionic input components, Angular services for state management, route guards, performance optimization, and testing. Do not use for creating a new Ionic app from scratch, upgrading Ionic versions, general Ionic component usage unrelated to Angular, Capacitor plugin integration, or non-Angular frameworks (React, Vue).
ionic-expert
capawesome-team/skills
A comprehensive starting point for AI agents to work with the Ionic Framework. Covers core concepts, components, CLI, theming, layout, lifecycle, navigation, and framework-specific patterns for Angular, React, and Vue. Pair with the other Ionic skills in this collection for deeper topic-specific guidance like app creation, framework integration, and upgrades.
ionic-app-development
capawesome-team/skills
Guides the agent through general Ionic Framework development including core concepts, component reference, CLI usage, layout, theming, animations, gestures, development workflow, and troubleshooting. Covers all Ionic UI components grouped by category with properties, events, methods, slots, and CSS custom properties. Do not use for creating a new Ionic app (use ionic-app-creation), framework-specific patterns (use ionic-angular, ionic-react, ionic-vue), or upgrading Ionic versions (use ionic-app-upgrades).
capacitor-app-development
capawesome-team/skills
Guides the agent through general Capacitor app development topics. Covers core concepts (native bridge, plugins, web layer), Capacitor CLI usage, app configuration (capacitor.config.ts, splash screens, app icons, deep links), platform management (Android, iOS, Electron, PWA), edge-to-edge and safe area handling on Android, live reload setup, storage solutions, file handling, security best practices, CI/CD references, iOS package managers (SPM, CocoaPods), and troubleshooting for Android and iOS. Do not use for creating new Capacitor apps, Capacitor plugin APIs, creating Capacitor plugins, in-app purchases, upgrading Capacitor versions, Cordova or PhoneGap migration, or framework-specific patterns (Angular, React, Vue).
capacitor-expert
capawesome-team/skills
A comprehensive starting point for AI agents to work with Capacitor. Covers core concepts, CLI, app creation, plugins, framework integration, best practices, storage, security, testing, troubleshooting, upgrading, and Capawesome Cloud (live updates, native builds, app store publishing). Pair with the other Capacitor skills in this collection for deeper topic-specific guidance.
Popular ai & agents skills
google-agents-cli-publish
google/agents-cli
This skill should be used when the user wants to "publish an agent", "publish my ADK agent", "register an agent with Gemini", "publish to Gemini" (formerly Gemini Enterprise), or needs guidance on the agents-cli publish gemini command. Also use when the user wants to "manage agents in Agent Registry", "list/update/delete registered agents", or "register an MCP server". Covers ADK vs A2A registration modes, programmatic and interactive usage, flag reference, auto-detection from deployment metadata, Agent Registry fleet management, and troubleshooting. Part of the agents-cli skills suite. Do NOT use for deployment (use google-agents-cli-deploy).
google-agents-cli-eval
google/agents-cli
This skill should be used when the user wants to "run an evaluation", "evaluate my agent", "evaluate my ADK agent", "write an eval dataset", "analyze eval failures", "compare eval results", "optimize agent", or needs guidance on the Gemini platform eval methodology and the Quality Flywheel. Covers eval metrics, dataset schema, LLM-as-judge scoring, and common failure causes. Applies to any agents-cli project, whatever framework the agent is written in. Do NOT use for agent API code patterns (ADK: use google-agents-cli-adk-code), deployment (use google-agents-cli-deploy), or project scaffolding (use google-agents-cli-scaffold).
skill-creator
anthropics/skills
Create new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.
codex-pet
prime-skills/runcomfy-agent-skills
Codex Pet generator on RunComfy. Build a Codex-compatible Codex Pet spritesheet.webp + pet.json from a single reference image, drop it into ${CODEXHOME:-$HOME/.codex}/pets/ / and Codex picks it up as a custom Codex Pet next to the 8 built-ins. This skill produces the exact Codex Pet atlas Codex expects (1536x1872 PNG/WebP, 8 cols x 9 rows, 192x208 cells, 9 animation states — idle, running-right, running-left, waving, jumping, failed, waiting, running, review). Calls OpenAI GPT Image 2 edit ONCE via the local RunComfy CLI as runcomfy run openai/gpt-image-2/edit to produce a canonical Codex Pet pose, then assembles all 9 animation rows programmatically with ImageMagick micro-transforms — no Codex Pro, no $imagegen, no OPENAIAPIKEY required, only RUNCOMFYTOKEN. Triggers on "codex pet", "create codex pet", "make codex pet", "hatch codex pet", "/hatch image", "desktop pet codex", "codex pets", "spritesheet.webp", or any explicit ask to build a custom pet for OpenAI Codex.
full-output-enforcement
leonxlnx/taste-skill
Overrides default LLM truncation behavior. Enforces complete code generation, bans placeholder patterns, and handles token-limit splits cleanly. Apply to any task requiring exhaustive, unabridged output.
executing-plans
obra/superpowers
Use when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available