---
id: types-caldav
version: "1.3.0.20250516"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# types-caldav — Typing stubs for caldav

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

## What it is and what it does

types-caldav is a PEP 561 type stub package that provides type annotations for the caldav library. It allows static type checkers—mypy, pyright, pytype, Pyre, and PyCharm—to understand and validate code using caldav. The stubs are marked as partial, meaning some annotations may be incomplete, and the package targets caldav 1.3.x specifically.

This package is part of the typeshed project and is primarily useful if you are using caldav 1.3.x and want static type checking during development. If you are already using caldav 1.4.0 or later, the caldav package itself includes type annotations, making types-caldav redundant.

Use it for:

- Enable mypy or pyright to type-check caldav code in a project using caldav 1.3.x
- Catch type errors in calendar operations before runtime in development
- Integrate caldav type information into an IDE like PyCharm for autocomplete
- Validate CalDAV interactions in a CI/CD pipeline with strict type checking

## Worth the install?

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

Provides type stubs for caldav, enabling static type checkers like mypy, pyright, and pytype to validate code using caldav.

Yes, if you are using caldav 1.3.x and want static type checking. No, if you are already on caldav 1.4.0 or later—uninstall this package and rely on caldav's built-in annotations instead. The stubs are partial and actively maintained, but their value is conditional on your caldav version.

## Install

pip install types-caldav
uv add types-caldav
poetry add types-caldav

## Installing types-caldav

Before you install: Low install friction with only two runtime dependencies. Actively maintained as part of the typeshed project with recent releases.

License in practice: Apache-2.0 is permissive and poses no licensing restrictions for use or redistribution.

Quickstart:

pip install types-caldav

Then use with your type checker in your project configuration (e.g., mypy.ini or pyrightconfig.json) to enable type checking of caldav code.

Requires Python >=3.9. Only useful if you are using caldav 1.3.x; caldav 1.4.0 and later include built-in type annotations.

Verify before relying:

- Whether partial stub coverage is sufficient for your specific caldav usage patterns
- Exact caldav 1.3.x minor versions this stub package targets

## Package facts

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

## Tags

caldav type stubs, type checking caldav, mypy caldav annotations, pep 561 stubs, static type checking calendar, pyright caldav types, type-stubs, static-analysis

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