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

Project template

This project is generated and maintained with copier-python.

Release files for jmapc 0.3.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.3.0
File Size Uploaded
jmapc-0.3.0.tar.gz 46.6 kB Details

Built distribution (wheel)

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

Total release size: 83.3 kB

Release files / jmapc-0.3.0.tar.gz

Download URL jmapc-0.3.0.tar.gz
Size 46.6 kB
Tags Source
SHA-256 checksum
How to use checksums
66b22e0217ab914d2a0ff788f17db2985630110f4b43be71db407ab91488aac0
BLAKE2b-256 checksum
How to use checksums
d4413ccc2078893827beb82c0154f4cab0bd35ecc8cbc4e76841f0288aa031c6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.12

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 May 23, 2026.

Transparency log

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

Download URL jmapc-0.3.0-py3-none-any.whl
Size 36.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
8380fff64c9f0ccf5da167a9cfdf47675678571a88bd0c194e64659c847dd1c8
BLAKE2b-256 checksum
How to use checksums
92db685ec010eba840f5f94dc486787ef664df038615ca37bc43f835b63de55f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.12

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 May 23, 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