---
title: Capacitor MCP Server
description: Connect Claude, Cursor, VS Code, and any MCP client to the official Capacitor documentation, plugin list, and blog with a free hosted MCP server.
---

# Capacitor MCP Server

The Capacitor MCP server gives your AI assistant the current [Capacitor](https://capacitorjs.com){:target="_blank"} documentation for v8, v7, v6 and `next`, the official and community plugin list, and the Capacitor posts from the Ionic blog — so it stops guessing plugin APIs and CLI flags. It implements the [Model Context Protocol](https://modelcontextprotocol.io){:target="_blank"}, so it works with Claude Code, Claude Desktop, Cursor, VS Code, and any other MCP client.

!!! info "Unofficial server"

    This server 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](https://www.apache.org/licenses/LICENSE-2.0){:target="_blank"}.

## Endpoint

The server is hosted by us and ready to use. No account, no token, no installation:

```
https://capacitor-mcp.capawesome.io/mcp
```

## Setup

Add the server to your MCP client and restart it.

=== "Claude Code"

    Run the following command in your project:

    ```bash
    claude mcp add --transport http capacitor https://capacitor-mcp.capawesome.io/mcp
    ```

    Add `--scope user` to make the server available in every project instead of just the current one.

=== "Claude Desktop"

    Go to **Settings → Connectors → Add custom connector** and enter:

    - **Name**: `Capacitor`
    - **URL**: `https://capacitor-mcp.capawesome.io/mcp`

    The same connector works on [claude.ai](https://claude.ai){:target="_blank"}.

=== "Cursor"

    [![Install in Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](cursor://anysphere.cursor-deeplink/mcp/install?name=capacitor&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vY2FwYWNpdG9yLW1jcC5jYXBhd2Vzb21lLmlvL21jcCJ9)

    Or add the following to `.cursor/mcp.json` in your project, or to `~/.cursor/mcp.json` to use the server everywhere:

    ```json
    {
      "mcpServers": {
        "capacitor": {
          "url": "https://capacitor-mcp.capawesome.io/mcp"
        }
      }
    }
    ```

=== "VS Code"

    [Install in VS Code](https://insiders.vscode.dev/redirect/mcp/install?name=capacitor&config=%7B%22name%22%3A%22capacitor%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fcapacitor-mcp.capawesome.io%2Fmcp%22%7D){:target="_blank"}

    Or add the following to `.vscode/mcp.json` in your project:

    ```json
    {
      "servers": {
        "capacitor": {
          "type": "http",
          "url": "https://capacitor-mcp.capawesome.io/mcp"
        }
      }
    }
    ```

=== "Windsurf"

    Add the server to `~/.codeium/windsurf/mcp_config.json`:

    ```json
    {
      "mcpServers": {
        "capacitor": {
          "serverUrl": "https://capacitor-mcp.capawesome.io/mcp"
        }
      }
    }
    ```

=== "Zed"

    Add the server to your Zed `settings.json`:

    ```json
    {
      "context_servers": {
        "capacitor": {
          "url": "https://capacitor-mcp.capawesome.io/mcp"
        }
      }
    }
    ```

=== "Any client"

    Clients that cannot connect to a remote server over HTTP can run the [`@capawesome/capacitor-mcp`](https://www.npmjs.com/package/@capawesome/capacitor-mcp){:target="_blank"} package, which proxies stdio to the hosted server:

    ```json
    {
      "mcpServers": {
        "capacitor": {
          "command": "npx",
          "args": ["-y", "@capawesome/capacitor-mcp"]
        }
      }
    }
    ```

    Requires Node.js 22 or later.

Once connected, ask your assistant something like *"How do I configure deep links in Capacitor 8?"* or *"Which Capacitor plugin should I use to pick a file?"* to check that the tools are available.

## Tools

| Tool | Description | Parameters |
| --- | --- | --- |
| `search_docs` | Search the documentation by keyword. The starting point for any Capacitor question. | `query` (required), `section`, `version`, `limit` |
| `get_doc_page` | Fetch a full documentation page returned by `search_docs` as Markdown. | `url` (required), `version` |
| `list_plugins` | List official and community Capacitor plugins. | `query`, `source`, `limit` |
| `list_blog_posts` | List recent Capacitor posts from the Ionic blog. | — |

`list_plugins` takes a `source` of `official`, `community` or `all`. Official plugins come from the Capacitor documentation, community plugins from [awesome-capacitorjs](https://github.com/capawesome-team/awesome-capacitorjs){:target="_blank"}. Results are ranked official plugins first, then Capawesome plugins, then the remaining community plugins. The server discloses that ranking in its response, so your assistant can weigh it.

## Versions

The documentation is available for Capacitor **v8** (default), **v7**, **v6** and **next**. Pass the `version` parameter to `search_docs` and `get_doc_page` to target a specific version.

Set it to the major version of `@capacitor/core` in your project. On Capacitor 7, `version: "v7"` keeps the answers on the APIs and CLI flags that release actually has.

## Documentation source

The index is rebuilt daily from [`ionic-team/capacitor-docs`](https://github.com/ionic-team/capacitor-docs){:target="_blank"} at a pinned commit. The documentation content is © the Ionic team, licensed under [Apache-2.0](https://www.apache.org/licenses/LICENSE-2.0){:target="_blank"}, converted from MDX to Markdown for delivery over MCP and otherwise served unmodified in substance. Blog excerpts come from the [Ionic blog](https://ionic.io/blog){:target="_blank"} and link to the original post.

The server is open source at [`capawesome-team/capacitor-mcp`](https://github.com/capawesome-team/capacitor-mcp){:target="_blank"}.

## Rate limits

The endpoint is limited to **100 requests per minute per IP**. Requests over the limit are answered with `429 Too Many Requests`; retry after a short wait.

## Privacy

Your IP address is processed for rate limiting only. Queries and tool arguments are not stored, not logged beyond Cloudflare's standard edge logs, and never used for training. See our [privacy policy](https://capawesome.io/legal/privacy-policy/){:target="_blank"} for details.

## Related servers

- [Ionic Framework MCP Server](ionic-framework.md) — the same for the Ionic Framework documentation, its component API reference, and the usage examples for Angular, React, Vue and vanilla JavaScript.
- [Capawesome MCP Server](capawesome.md) — the Capawesome documentation and the Capawesome Cloud management API for Live Updates, Native Builds, and App Store Publishing.