Skip to main content

jmapc

A JMAP client library for Python

License PyPI Python CI Coverage Renovate GitHub stars

jmapc

Currently implemented:

  • Basic models
  • Request methods:
    • Core/echo
    • Email/changes
    • Email/copy
    • Email/get
    • Email/query
    • Email/queryChanges
    • Email/set
    • EmailSubmission/* (get, changes, query, queryChanges, set)
    • Identity/* (get, changes, set)
    • Mailbox/* (get, changes, query, queryChanges, set)
    • SearchSnippet/* (get)
    • Thread/* (get, changes)
    • Arbitrary methods via the CustomMethod class
  • Fastmail-specific methods:
  • Combined requests with support for result references
  • Basic JMAP method response error handling
  • EventSource event handling
  • Unit tests for basic functionality and methods

Installation

Install in any environment where pip is available:

pip install jmapc

Installation in projects

Install in a project, such as with uv or poetry:

uv add jmapc
poetry add jmapc

Examples

Any of the included examples can be invoked with uv run:

JMAP_HOST=jmap.example.com \
JMAP_API_TOKEN=ness__pk_fire \
uv run examples/identity_get.py

If successful, examples/identity_get.py should output something like:

Identity 12345 is for Ness at ness@onett.example.com
Identity 67890 is for Ness at ness-alternate@onett.example.com

License

Copyright (C) 2022 Stephen Kent and contributors

Licensed under the GNU General Public License v3.0 only (GPL-3.0-only).

Project template

This project is generated and maintained with copier-python.

Metadata

Release files for jmapc 0.4.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for jmapc 0.4.0
File Size Uploaded
jmapc-0.4.0.tar.gz 46.1 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for jmapc 0.4.0
File Interpreter ABI Platform
jmapc-0.4.0-py3-none-any.whl Python 3 none any Details

Total release size: 82.9 kB

Release files / jmapc-0.4.0.tar.gz

Download URL jmapc-0.4.0.tar.gz
Size 46.1 kB
Tags Source
SHA-256 checksum
How to use checksums
823892b467ee53c2c6a0907058f5da7583a6a9dfa0fb4b9ba8302524c576fe66
BLAKE2b-256 checksum
How to use checksums
81b46e85d7dcd5673a12e92a93bba597e9c45fb8cf68a66e19eb4c0197861d63
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 11, 2026.

Transparency log

Release files / jmapc-0.4.0-py3-none-any.whl

Download URL jmapc-0.4.0-py3-none-any.whl
Size 36.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
6083509f8bec6a25faeb17b60358c00d5f96d39d8cddcba0d1cb4c3344272c1c
BLAKE2b-256 checksum
How to use checksums
75df3c265d64ac3e6c544c9464b1ad396766cc69d6235229c550e23f1a44be6d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 11, 2026.

Transparency log
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page