---
id: nocodb-simple-client
version: "1.3.6"
license: MIT
license_treatment: permissive
maintenance: active
---

# nocodb-simple-client — A simple and powerful NocoDB REST API client for Python

License: permissive · Maintenance: active · Downloads: 622.6K/mo

## 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 above — 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

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

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 622.6K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

nocodb python client, nocodb rest api wrapper, nocodb crud operations, nocodb database client, nocodb bulk operations, low-code database client, nocodb file management, nocodb-integration, rest-api-client, database-abstraction

[View on SkillFed](https://skillfed.io/packages/nocodb-simple-client) · [View on PyPI](https://pypi.org/project/nocodb-simple-client/)