.. SPDX-FileCopyrightText: 2026 calendaring-jmap contributors
.. SPDX-License-Identifier: AGPL-3.0-or-later

================
calendaring-jmap
================

.. meta::
   :description: A Python client library for calendar operations over JMAP (RFC 8620, JMAP core) and the JMAP Calendars draft, with synchronous and asynchronous clients.

A Python client library for calendar operations over JMAP (:rfc:`8620`, JMAP core) and the JMAP Calendars draft, with synchronous and asynchronous clients.

.. grid:: 2
    :gutter: 2

    .. grid-item-card:: 🚀 Quickstart
        :link: tutorials/quickstart
        :link-type: doc

        List your calendars in a few lines.

    .. grid-item-card:: 📋 How-to guides
        :link: how-to/install
        :link-type: doc

        Install, authenticate, and work with calendars, events, and more.

    .. grid-item-card:: 📖 Reference
        :link: reference/index
        :link-type: doc

        Every class and method, generated from the source.

    .. grid-item-card:: 💡 Design
        :link: explanation/design
        :link-type: doc

        Why the client is built the way it is.

    .. grid-item-card:: 🤝 Contribute
        :link: contribute
        :link-type: doc

        Set up a dev environment, run tests, submit a PR.

    .. grid-item-card:: 🔒 Security
        :link: security
        :link-type: doc

        Report a vulnerability, and known risks.

.. toctree::
   :hidden:

   tutorials/quickstart
   how-to/index
   reference/index
   explanation/index
   contribute
   security
   release