Fastmail Calendar

Provides MCP access to Fastmail Calendar via CalDAV, enabling list, create, update, and delete calendar events.

javascript

2

GitHub Stars

javascript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "nova-3951-fastmail-calendar-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "fastmail-calendar-mcp"
      ],
      "env": {
        "FASTMAIL_USERNAME": "your-email@fastmail.com",
        "FASTMAIL_APP_PASSWORD": "your-app-password"
      }
    }
  }
}

You can connect an AI assistant to your Fastmail Calendar through CalDAV using this MCP server. It lets you view calendars, list events within date ranges, and create, update, or delete events in your Fastmail account, all through simple MCP requests.

How to use

Interact with the Fastmail Calendar MCP Server by issuing high-level actions from your MCP client. You can: view all calendars in your account, fetch events for a specific calendar within a date range, create new events with details like title, description, location, and times, modify existing events, or remove events. The tools provided map directly to these operations and return structured results you can use in your assistant’s responses.

How to install

Prerequisites: you need Node.js and npm installed on your machine. You also need a Fastmail account to generate an app password for secure access.

Option 1: Install via Smithery (recommended for streamlined setup)

smithery install fastmail-calendar-mcp --client claude --config '{"username":"your-email@fastmail.com","appPassword":"your-app-password"}'

Option 2: Manual installation for Claude Desktop (configuration snippet)

{
  "mcpServers": {
    "fastmail-calendar": {
      "command": "npx",
      "args": [
        "-y",
        "fastmail-calendar-mcp"
      ],
      "env": {
        "FASTMAIL_USERNAME": "your-email@fastmail.com",
        "FASTMAIL_APP_PASSWORD": "your-app-password"
      }
    }
  }
}

Additional setup for Cursor IDE

If you are using Cursor IDE, add the MCP connection to your Cursor configuration.

{
  "mcpServers": {
    "fastmail-calendar": {
      "command": "node",
      "args": ["/path/to/fastmail-calendar-mcp/dist/index.js"],
      "env": {
        "FASTMAIL_USERNAME": "your-email@fastmail.com",
        "FASTMAIL_APP_PASSWORD": "your-app-password"
      }
    }
  }
}

Available tools

list_calendars

Lists all calendars in your Fastmail account and returns objects with displayName, url, description, and timezone.

list_events

Lists events from a specific calendar within a date range and returns event data including url, etag, and iCalendar data.

create_event

Creates a new calendar event with a specified calendar, summary, startDate, endDate, and optional description and location.

update_event

Updates an existing calendar event identified by its event URL, with optional new summary, description, dates, and location.

delete_event

Deletes a calendar event identified by its URL and etag.