ebarooni/capacitor-calendar-mcp

An official MCP server for @ebarooni/capacitor-calendar. Gives AI coding assistants accurate, grounded knowledge of the plugin: native permission setup, API reference, and config validation.

Built with Quarkus. Published to the GitHub Container Registry.

Install

Run the server with Docker:

docker run --rm -d --name capacitor-calendar-mcp -p 8080:8080 ghcr.io/ebarooni/capacitor-calendar-mcp:1.2.0

The server starts at http://localhost:8080/mcp.

If port 8080 is busy, map it to a free port:

docker run --rm -d --name capacitor-calendar-mcp -p 9090:8080 ghcr.io/ebarooni/capacitor-calendar-mcp:1.2.0

The server is then available at http://localhost:9090/mcp. Update your client configuration to match.

To stop the server:

docker stop capacitor-calendar-mcp

Configure Your AI Client

Claude Code

Run the following command in your terminal:

claude mcp add-json capacitor-calendar '{"type":"http","url":"http://localhost:8080/mcp"}'

This adds the server to your user scope, making it available across all projects. To scope it to a single project instead, add --scope project to the command.

Cursor

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "capacitor-calendar": {
      "type": "http",
      "url": "http://localhost:8080/mcp"
    }
  }
}

GitHub Copilot

Open mcp.json in your editor and add the following:

VS Code: Command Palette → MCP: Open User Configuration

JetBrains: GitHub Copilot icon → Edit Settings → MCP Servers → Configure

{
  "servers": {
    "capacitor-calendar": {
      "type": "http",
      "url": "http://localhost:8080/mcp"
    }
  }
}

Verify

Restart your AI client, then ask it something only the server would know, for example:

Which @ebarooni/capacitor-calendar methods are iOS-only?

A grounded, correct answer confirms your client reached the server. If the answer looks generic or wrong, check that the container is running (docker ps) and that the URL and port in your client config match the server.

What's Available

Resources

URI	Description
`docs://permissions/android`	Required `AndroidManifest.xml` entries for calendar access
`docs://permissions/ios`	Required `Info.plist` keys for calendar and reminders access
`docs://web-behavior`	Web export model: ICS, no permission APIs, ignored options

Tools

Tool	Description
`getMethod`	Returns the description, supported platforms, and since version for a specific method
`listMethods`	Lists all plugin methods, optionally filtered by platform
`searchMethods`	Searches methods by keyword, optionally filtered by platform
`validateAndroidManifest`	Validates an `AndroidManifest.xml` for correct permission configuration
`validateInfoPlist`	Validates an iOS `Info.plist` for correct permission configuration

Prompts

Prompt	Description
`choose-access-level`	Recommends the right access level based on which methods your app uses
`debug-permission-denied`	Diagnostic flow for when calendar permission is always denied
`setup-for-platform`	Walks through native permission setup for a given platform

Versioning

All available versions are listed on the GitHub Packages page. Always pin the version tag, as shown in Install, instead of tracking a moving tag.

Local Development

Prerequisites: JDK 25+, Maven 3.9+

# Run with live reload
mvn quarkus:dev

The server starts at http://localhost:8080/mcp. The Dev UI at http://localhost:8080/q/dev-ui lets you test tools, resources, and prompts interactively without an MCP client.

# Build the Docker image
mvn install -Ddocker.skip.push=true

License

This project is licensed under the MIT License. See LICENSE for details.

MCP Server - HTTP (guide): The HTTP/SSE transport for the MCP server.