# capacitor-mcp

Feeds your assistant current Capacitor documentation, the plugin list and Ionic blog posts. Useful when the agent keeps inventing plugin APIs and CLI flags.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 1
- Author: capawesome-team
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/capawesome-team/capacitor-mcp
- Updated: 2026-09-08
- HTML: https://affpapa.org/en/nevibecode/mcp/capacitor-mcp

## What it does

The server is hosted by Capawesome, so there is nothing to run locally. Four tools come with it: `search_docs` for keyword lookups, `get_doc_page` to read a page in full, `list_plugins` for official and community plugins, and `list_blog_posts` for recent Ionic blog entries. Docs cover Capacitor v8, v7, v6 and `next`; pass the `version` parameter to `search_docs` and `get_doc_page` to pick one. Without it you get v8.

Wiring it up takes one line in your client config. In Claude that is `claude mcp add --transport http capacitor-mcp https://capacitor-mcp.capawesome.io/mcp`. Clients that cannot speak HTTP go through the `@capawesome/capacitor-mcp` proxy over stdio, which needs Node.js 22 or newer.

The endpoint allows 100 requests per minute per IP. Go over that and you get `429 Too Many Requests`; wait a moment and retry. Your IP is handled for that limit alone — the queries themselves and the tool arguments are not kept and do not feed training. This is an unofficial project, with no ties to Ionic or OutSystems.

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

## Install

### Claude Code (native platform)

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

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

### Codex

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

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

### Cursor

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

### GitHub Copilot

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

### Gemini CLI

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

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

## When to use it
- check a plugin method signature without leaving the editor
- find a community plugin for a specific job
- match answers to the Capacitor version you actually ship
- catch up on recent Ionic blog posts
- read a full doc page from a search hit

## Example prompts
- Search the Capacitor docs for push notification setup
- List plugins that handle the camera
- Open the `CapacitorHttp` doc page for v7

## Similar
- [capacitor-keyboard](https://affpapa.org/en/nevibecode/skills/capacitor-keyboard.md) — skill · 1000 installs
- [cordova-to-capacitor](https://affpapa.org/en/nevibecode/skills/cordova-to-capacitor.md) — skill · 768 installs
- [ionic-enterprise-sdk-migration](https://affpapa.org/en/nevibecode/skills/capawesome-team-ionic-enterprise-sdk-migration.md) — skill · 723 installs
- [ionic](https://affpapa.org/en/nevibecode/skills/ionic.md) — skill · 797 installs
- [ionic-react](https://affpapa.org/en/nevibecode/skills/ionic-react.md) — skill · 717 installs
- [otakit](https://affpapa.org/en/nevibecode/mcp/otakit.md) — MCP server · ★ 46

---
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