nocodb-simple-client

What it is and what it does

nocodb-simple-client is a Python wrapper around the NocoDB REST API that abstracts away HTTP details and provides a Pythonic interface for database operations. It handles CRUD operations on records, bulk inserts/updates/deletes, file attachment management, and complex filtering and sorting queries. The library supports both NocoDB API v2 (default, fully backward compatible) and v3 with automatic parameter conversion—meaning code written for v2 continues to work unchanged when you switch API versions.

The package is built on pydantic for validation, requests for HTTP transport, and requests-toolbelt for file handling. It includes context manager support for automatic resource cleanup, comprehensive type hints for IDE integration, and flexible configuration via environment variables, files, or direct parameters. The library is marked production-ready and actively maintained, with support for modern Python versions (3.10 through 3.14).

Use it for:

• Build a Python application that reads and writes records to a NocoDB database without writing raw HTTP requests.
• Perform bulk insert or update operations on hundreds or thousands of records in a single call.
• Upload or download file attachments associated with NocoDB records programmatically.
• Migrate data between NocoDB instances or from another database into NocoDB using the client's CRUD methods.
• Automate NocoDB workspace, base, table, and field management via the Meta API without manual UI interaction.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

A Python client library for NocoDB that provides CRUD operations, bulk operations, file management, and advanced querying against NocoDB REST API with support for both v2 and v3 API versions.

Yes. The package has low install friction (three lightweight dependencies), is actively maintained with no known vulnerabilities, carries a permissive MIT license, and provides a well-documented, type-hinted interface to NocoDB's REST API. It is suitable for production use if you need programmatic access to NocoDB from Python.

Install

nocodb-simple-client on PyPI

pip install nocodb-simple-client

uv add nocodb-simple-client

poetry add nocodb-simple-client

Installing nocodb-simple-client

Before you install

Low friction: pure Python wheel with only three runtime dependencies (pydantic, requests, requests-toolbelt). Last commit 2026-07-21 with active maintenance status.

License in practice

MIT license (permissive) — you can use, modify, and distribute this package freely in commercial and private projects with minimal restrictions.

Quickstart

pip install nocodb-simple-client

from nocodb_simple_client import NocoDBClient, NocoDBTable

with NocoDBClient(
    base_url="https://your-nocodb-instance.com",
    db_auth_token="your-api-token"
) as client:
    table = NocoDBTable(client, table_id="your-table-id")
    records = table.get_records(limit=10)

Requires Python 3.10 or later; NocoDB instance URL and API token must be provided.

Verify before relying

• Whether optional extras (cli, async, config, dotenv) are production-ready or experimental.
• Performance characteristics for bulk operations on large datasets.
• Specific error types and exception hierarchy for application error handling.

Package facts

Evidence: nocodb_simple_client-1.3.6-py3-none-any.whl

Keywords: api, client, database, low-code, no-code, nocodb, rest

Tags

More Python Modules packages