Monday.com Python Client

2.2.1 verified Fri May 01 auth: no python

A Python client library for Monday.com's GraphQL API. Supports CRUD operations on boards, items, columns, workspaces, and tags. Current version 2.2.1, with frequent releases.

pip install monday

Common errors

error ModuleNotFoundError: No module named 'monday' ↓

cause Library not installed.

fix

Run pip install monday

error requests.exceptions.MissingSchema: Invalid URL 'None' ↓

cause API key not set or passed as None.

fix

Ensure you pass a valid API key string to MondayClient.

error TypeError: 'NoneType' object is not iterable ↓

cause Query returned None because of missing fields or empty parentheses (v2.0.0+).

fix

Use explicit field names in GraphQL queries instead of empty parentheses.

Warnings

breaking v2.2.0 migrated from requests to urllib3. If you were directly using the underlying session or requests-specific code, update accordingly. ↓

fix Upgrade to >=2.2.0 and replace any references to `monday.session` or requests-specific objects.

breaking v2.0.0 dropped support for empty parentheses in GraphQL fields. Use explicit field names instead. ↓

fix Replace queries like `items()` with `items { id name }`.

gotcha The library requires Python >=3.11 as of v2.0.3. Older Python versions are not supported. ↓

fix Use Python 3.11 or later.

Imports

MondayClient
wrong
```
from monday.client import MondayClient
```
correct
```
from monday import MondayClient
```
The main client class is importable directly from the monday package.

Quickstart

Initialize MondayClient with your API key and fetch all boards.

from monday import MondayClient

# Initialize client with your API key
client = MondayClient(os.environ.get('MONDAY_API_KEY', ''))

# Fetch all boards
boards = client.boards.fetch_all()
print(boards)