# Smart Calendars AI MCP server

Create and update subscription calendars from ChatGPT, Claude, or Codex.

## At a glance

Smart Calendars AI is an MCP server in the Productivity category. It is hosted remotely and connects over HTTP, and declares no required credentials. It exposes 7 tools, including create_feed, list_feeds and get_feed. It scores D (33/100) on the MCP Skills Hub health score as of Oct 28, 2026.

## Install

### How to install Smart Calendars AI in Claude Code

1. Add the server

```bash
claude mcp add --transport http smart-calendars-ai https://api.smartcalendars.ai/mcp
```

2. Verify it's connected

```bash
claude mcp list
```

3. Sharing it with your team?

   Add `--scope project` to write it to .mcp.json in the repository root, which you can commit (with the secrets left as environment variables).

4. Use it in a session

   Ask Claude to use the tools this server exposes (e.g. create_feed, list_feeds, get_feed). It discovers them automatically.

### How to install Smart Calendars AI in Claude Desktop

1. Open your MCP config

   macOS: ~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

2. Add this server

```json
{
  "mcpServers": {
    "smart-calendars-ai": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.smartcalendars.ai/mcp"
      ]
    }
  }
}
```

3. Why the wrapper?

   This is a remote (HTTP) server and Claude Desktop only launches local processes, so mcp-remote proxies the connection. It will open a browser window if the server needs OAuth.

4. Restart Claude Desktop

   The tools appear under the 🔌 menu once the app reloads.

### How to install Smart Calendars AI in Cursor

1. Create / edit .cursor/mcp.json in your project

```json
{
  "mcpServers": {
    "smart-calendars-ai": {
      "url": "https://api.smartcalendars.ai/mcp"
    }
  }
}
```

2. Enable it

   Cursor Settings → MCP → toggle the server on. Tools become available to the Composer/Agent.

### How to install Smart Calendars AI in Codex CLI

1. Add to ~/.codex/config.toml

```toml
[mcp_servers.smart-calendars-ai]
command = "npx"
args = ["-y", "mcp-remote", "https://api.smartcalendars.ai/mcp"]
```

2. Why the wrapper?

   Codex runs MCP servers as local processes, so mcp-remote bridges this HTTP endpoint to stdio.

3. Run Codex

   Codex loads MCP servers from config.toml on startup and exposes their tools to the agent.

### How to install Smart Calendars AI in Windsurf

1. Edit ~/.codeium/windsurf/mcp_config.json

```json
{
  "mcpServers": {
    "smart-calendars-ai": {
      "serverUrl": "https://api.smartcalendars.ai/mcp"
    }
  }
}
```

2. Reload

   Windsurf → Cascade → refresh MCP servers. Cascade can now call the tools.

### How to install Smart Calendars AI in Cline

1. Open Cline → MCP Servers → Configure

   Adds to cline_mcp_settings.json.

2. Add the server

```json
{
  "mcpServers": {
    "smart-calendars-ai": {
      "type": "streamableHttp",
      "url": "https://api.smartcalendars.ai/mcp"
    }
  }
}
```

### How to install Smart Calendars AI in VS Code

1. Create .vscode/mcp.json

```json
{
  "servers": {
    "smart-calendars-ai": {
      "type": "http",
      "url": "https://api.smartcalendars.ai/mcp"
    }
  }
}
```

2. Start it

   VS Code shows a ▶ Start action above the server entry. Agent mode (Copilot Chat) can then use the tools.

## Tools

- `create_feed` — Creates a subscription calendar from user-reviewed structured events and optionally activates it. Intended for an explicit request to save a schedule. The caller supplies the events; source-document extraction and automatic monitoring are not performed. Existing account feed and creation allowances apply. Identical retries retain the original request_id and payload. publication.status reports cale
- `list_feeds` — Lists the connected account’s feeds, management links and shared active-feed allowance for a requested calendar lookup. Only feeds marked counts_towards_active_limit use a slot; this page’s length is not the account’s usage. Reading changes no feeds or subscription access. Scope is limited to the connected account’s Smart Calendars AI feeds. No mailbox access, source-document retrieval, automatic 
- `get_feed` — Reads events and the current revision of a selected feed for a requested schedule lookup or revision. include_facets=true provides known facet values for label selection. Facets describe the entire published active feed, independent of read filters or pagination. Nonempty filters also return filtered_subscription with canonical filters, matching_event_count and unmatched_filter_values. Its nested 
- `get_feed_status` — Reads a selected feed’s last update, current subscription availability (distribution_ready), editing access and configured monitoring status for a requested status check. This does not refresh, save or charge. Scope is limited to the connected account’s Smart Calendars AI feeds. No mailbox access, source-document retrieval, automatic source monitoring, scheduled PDF checks or document refresh is p
- `apply_feed_changes` — Saves one revision to one existing calendar feed owned by the connected account for a user-approved schedule change. Accepts one fixed-schema change set with up to 250 event changes and/or a feed title or description change; all stored calendar changes commit together in one transaction, or none are saved. The schema declares every supported change: add creates an event; update changes selected fi
- `deactivate_feed` — Deactivates a feed for an explicit user request to interrupt its subscription access, without deleting events or resetting editing windows. User approval of that access interruption is required. A counted active feed releases its allowance slot. publication.status reports calendar-file preparation, not subscription access. distribution_ready reports subscription availability at the returned revisi
- `reactivate_feed` — Reactivates an existing feed for an explicit user request to restore its subscription access, subject to existing account allowances. Does not reset the original editing window or modify events. publication.status reports calendar-file preparation, not subscription access. distribution_ready reports subscription availability at the returned revision; availability may change afterward. Scope is lim

---

Source: https://mcp-skills-hub.vercel.app/mcps/ai-smartcalendars-smart-calendars-ai · MCP Skills Hub · data as of 2026-10-28T12:31:05Z
