---
id: types-icalendar
version: "6.3.2.20260712"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# types-icalendar — Typing stubs for icalendar

License: permissive · Maintenance: active · Downloads: 124.3K/mo

## What it is and what it does

types-icalendar is a type stub package that bridges the gap between the icalendar library and Python's static type checkers. It provides type annotations for icalendar 6.3.2, allowing mypy, pyright, and other type checkers to understand and validate code that uses icalendar's API for parsing and generating iCalendar format data. The package is maintained as part of the typeshed project, the canonical repository for type stubs in the Python ecosystem.

This package is most useful when working with icalendar 6.3.2 or earlier versions that lack built-in type annotations. It depends on two other type stub packages (types-python-dateutil and types-pytz) to provide complete type information for icalendar's date and timezone handling. The package is actively maintained and carries no known security vulnerabilities.

Use it for:

- Enable mypy or pyright type checking in projects using icalendar 6.3.2 for calendar event parsing and generation.
- Validate iCalendar data processing pipelines with static type analysis before runtime.
- Integrate icalendar into a strictly typed codebase where type safety is enforced across all dependencies.
- Catch type-related bugs in calendar integration code during development rather than at runtime.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides type stubs for the icalendar package, enabling static type checkers like mypy and pyright to validate code that uses icalendar for iCalendar format handling.

Yes, if you use icalendar 6.3.2 and rely on static type checking. Install friction is minimal and the package is actively maintained with no vulnerabilities. However, if you are already using icalendar 7.0.0 or later, uninstall this package—the library now includes its own type annotations, making this stub package redundant.

## Install

pip install types-icalendar
uv add types-icalendar
poetry add types-icalendar

## Installing types-icalendar

Before you install: Low install friction with only two type-stub runtime dependencies (types-python-dateutil and types-pytz). Actively maintained as of 2026-08-14 with no known vulnerabilities.

License in practice: Licensed under Apache-2.0 (permissive), allowing use in most projects without significant legal constraints.

Quickstart:

pip install types-icalendar

# In your code with mypy or pyright enabled:
import icalendar

cal = icalendar.Calendar()
# Type checker now understands icalendar's API

Requires Python 3.10 or later. Note: icalendar 7.0.0+ includes its own type annotations, so this package is redundant for those versions.

Verify before relying:

- Whether mypy 2.2.0 and pyright 1.1.411 remain the latest tested versions or if newer type checker versions have been validated since the package's last release.

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 124.3K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

type stubs icalendar, mypy icalendar typing, pyright icalendar annotations, icalendar type checking, static type hints calendar, typeshed icalendar stubs, type-stubs, type-checking

[View on SkillFed](https://skillfed.io/packages/types-icalendar) · [View on PyPI](https://pypi.org/project/types-icalendar/)