caldav
This project is a CalDAV (RFC4791) client library for Python.
Features:
- create, modify calendar
- create, update and delete event
- search events by dates
- async support via
caldav.aiomodule - etc.
Quick Start
from caldav import get_davclient
with get_davclient() as client:
principal = client.principal()
calendars = principal.get_calendars()
for cal in calendars:
print(f"Calendar: {cal.name}")
Async API
For async/await support, use the caldav.aio module:
import asyncio
from caldav import aio
async def main():
async with aio.get_async_davclient() as client:
principal = await client.principal()
calendars = await principal.get_calendars()
for cal in calendars:
print(f"Calendar: {cal.name}")
asyncio.run(main())
Documentation and other links
The user documentation (up-to-date with version 3.2) is embedded under docs/source - a rendered copy is available at https://caldav.readthedocs.io/
Other documentation:
- This file
- Changelog
- Contributors guide
- Contact information
- Code of Conduct
- Security Policy
- AI policy and AI disclaimer
- Apache License
- GPL license
There is also a directory docs/design containing lots of documents, mostly AI-generated, containing things like design decisions and other things that neither is deemed important enough to have a document on the root of the project nor deemed to be "user documentation".
The package is published at Pypi
HTTP Libraries
The sync client uses niquests by default (with fallback to requests). The async client prefers niquests as well, falling back to the httpx family (httpx2, httpxyz, httpx) - the first one installed wins. See HTTP Library Configuration for details.
Licences
The caldav library is dual-licensed under the GNU GENERAL PUBLIC LICENSE Version 3 or the Apache License 2.0.
Release files for caldav 3.3.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| caldav-3.3.1.tar.gz | 715.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| caldav-3.3.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size:981.3 kB
Release files / caldav-3.3.1.tar.gz
| Download URL | caldav-3.3.1.tar.gz |
|---|---|
| Size | 715.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
945948cd3eca7eb5866e674e8c51c8ce30db66446762ed72d5755cb37fd87bf1
|
|
BLAKE2b-256 checksum How to use checksums |
2dbbc8d18866749d5947342af869f0f5f4b616290a19d408806da3062f1bb810
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.7
|
Release files / caldav-3.3.1-py3-none-any.whl
| Download URL | caldav-3.3.1-py3-none-any.whl |
|---|---|
| Size | 265.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
f469371d30a5902a71ba383d4b1b030ef72053b882a351b285cb3e430babdcda
|
|
BLAKE2b-256 checksum How to use checksums |
597b1a80286115026c556a750f93bbb9c8a79ac84e9702687623075d596c8f35
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.7
|
