Capacitor Mcp

io.capawesomePublished by capawesome.ioOfficial publisherv0.0.1Updated Oct 24, 2026

Unofficial MCP server for the Capacitor documentation, plugin list and blog.

VerifiedStreamable HTTPWeb executableKnowledge & MemoryDeveloper Tools

Overview

AI-generated overview

Unofficial MCP server that gives assistants the official Capacitor docs, plugin lists and Ionic blog posts so they stop guessing APIs and CLI flags.

What you can do
  • Search the official Capacitor documentation by keyword, optionally scoped by section and version
  • Read a full documentation page in markdown after a search
  • List official and community Capacitor plugins with package names and maintainers
  • List the 10 most recent Capacitor posts from the Ionic blog
When to use it
Useful when building or maintaining a Capacitor app and you want the assistant to answer from current v8, v7, v6 or next documentation instead of guessing plugin APIs, CLI commands or native configuration. Also handy for finding a plugin for a native capability and for checking recent releases and deprecations.
Requirements
Nothing for the hosted endpoint: no account, token or installation. Clients that cannot use remote HTTP can run the npm package @capawesome/capacitor-mcp via npx, which needs Node.js 22 or later and proxies stdio to the hosted server.
Before you install
Read-only documentation lookup; no credentials are requested. The endpoint is rate limited to 100 requests per minute per IP, with 429 responses beyond that. Your IP address is processed for rate limiting, and queries pass through Cloudflare edge logs. It is unofficial and not affiliated with Ionic or OutSystems.

Installation

In SourceWeft

  1. Open Capacitor Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.capawesome%2Fcapacitor-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

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

README

Capacitor MCP Server

Unofficial MCP server for the official Capacitor documentation. It gives AI assistants the current documentation for Capacitor v8, v7, v6 and next, the official and community plugin list, and the Capacitor posts from the Ionic blog — so they stop guessing plugin APIs and CLI flags. Not affiliated with or endorsed by Ionic or OutSystems.

Maintained by Capawesome.

Endpoint

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

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

Installation

Claude Code

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

Claude Desktop / Claude.ai

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

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

Cursor

[Install in Cursor]

Or add .cursor/mcp.json to your project:

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

VS Code

Install in VS Code

Or add .vscode/mcp.json to 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 via npx

Clients that cannot connect to a remote server over HTTP can run this package, which proxies stdio to the hosted server:

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

Requires Node.js 22 or later.

Tools

ToolPurposeParameters
search_docsSearch the documentation by keyword. Start here for any Capacitor question.query (required), section, version, limit
get_doc_pageRead a full documentation page returned by search_docs.url (required), version
list_pluginsList official and community Capacitor plugins.query, source, limit
list_blog_postsList recent Capacitor posts from the Ionic blog.—

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.

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 the Privacy Policy for details.

Related

Attribution

The documentation content is © the Ionic team, licensed under Apache-2.0 and sourced from ionic-team/capacitor-docs. It is converted from MDX to Markdown for delivery over MCP and otherwise served unmodified in substance. The community plugin list comes from capawesome-team/awesome-capacitorjs. Blog excerpts come from the Ionic blog and link to the original post.

See NOTICE for the full attribution.

Development

bash
npm installnpm run buildnpm test

Set CAPACITOR_MCP_URL to point the proxy at a local server instead of the hosted one:

bash
CAPACITOR_MCP_URL=http://localhost:8787/mcp node dist/index.js

Release

Releases are managed by release-please. Merging its release pull request tags the version, publishes the package to npm and then publishes server.json to the MCP Registry. The version in server.json is bumped by release-please together with package.json, so it never has to be edited by hand. To publish to the registry manually, install mcp-publisher, run mcp-publisher login dns --domain=capawesome.io --private-key=<key> with the Ed25519 private key from the password manager and then mcp-publisher publish.

License

See LICENSE.

Source: README.md at commit 5cb0ab7

Tools

4

search_docs

Search Capacitor documentation

Search the official Capacitor documentation from capacitorjs.com by keyword. Use this first for any question about Capacitor itself — the CLI, the `capacitor.config` file, the native Android and iOS projects, the official plugin APIs, or upgrading to a newer major version — because guessing an API, a configuration option or a CLI flag produces broken code. Returns the best matching page sections with `title`, `url`, `snippet`, `section` and `version`, plus the `parentTitle` and `parentUrl` of the page a section belongs to. The same results are attached as structured content. Do not use this to read a whole page (call `get_doc_page` with a `url` from these results), to look up Capawesome plugins such as @capawesome/capacitor-file-picker or Capawesome Cloud services such as Live Updates, Native Builds and App Store Publishing (use the Capawesome MCP server at https://mcp.capawesome.io/mcp instead), or to look up Ionic Framework UI components (use the Ionic Framework MCP server at https://ionic-framework-mcp.capawesome.io/mcp instead).

Parameterslimitqueryrequiredsectionversion

get_doc_page

Read a documentation page

Read the full markdown of a single page of the official Capacitor documentation. Use this after `search_docs` to read a page end to end before writing code against a plugin API, a CLI command or a native configuration, because search snippets are deliberately short and regularly omit required setup steps. Returns the page title, its URL, the documentation version and the complete page markdown including code samples. Do not use this to find a page: it needs an exact URL or path, so run `search_docs` first. Do not use it for pages outside capacitorjs.com — Capawesome plugins and Capawesome Cloud are covered by the Capawesome MCP server at https://mcp.capawesome.io/mcp, Ionic Framework UI components by the Ionic Framework MCP server at https://ionic-framework-mcp.capawesome.io/mcp.

Parametersurlrequiredversion

list_plugins

List Capacitor plugins

List Capacitor plugins: the official plugins maintained by the Capacitor team and community plugins from the awesome-capacitorjs list maintained by Capawesome. Use this to find a plugin for a native capability before writing custom native code, and to learn which package name and maintainer a capability belongs to. Returns `name`, `description`, `source`, `maintainer` and `url` per plugin, plus `core: true` for a plugin that ships with @capacitor/core and `experimental: true` for an experimental one. Results are ranked by relevance, with official Capacitor plugins ranked first, then plugins maintained by Capawesome, then other community plugins. Do not use this to read a plugin's API: call `get_doc_page` with the `url` of an official plugin, and use the Capawesome MCP server at https://mcp.capawesome.io/mcp for Capawesome plugins.

Parameterslimitquerysource

list_blog_posts

List recent blog posts

List the 10 most recent posts from the Capacitor tag of the official Ionic blog, newest first. Use this when the question is about what is new — recent releases, announcements or deprecations. The blog covers both Capacitor and Ionic Framework. Returns `title`, `date`, `tags`, `url` and `excerpt` per post. Do not use this to answer a documentation question: the feed only carries the newest posts, so search the documentation with `search_docs` instead.

Takes no parameters.

Version history

1
  1. v0.0.1LatestSep 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Capawesome integrations