---
id: kanboard
version: "1.1.8"
license: MIT
license_treatment: permissive
maintenance: active
---

# kanboard — Python client library for Kanboard

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

## What it is and what it does

Kanboard is a Python client library that maps Kanboard's JSON-RPC API into Python method calls, letting you automate project and task management from your code. It supports both synchronous and asynchronous I/O patterns, handles authentication via API tokens or username/password, and includes error handling for network and API failures. The library uses named arguments and dynamically maps method names to API procedures, so the Python interface mirrors the official Kanboard API documentation.

You instantiate a Client with your Kanboard server URL and credentials, then call methods like create_project, create_task, or get_my_projects as context-managed objects. The client handles SSL certificates, custom authentication headers, request timeouts, and can be configured to work with self-signed certificates or custom certificate paths. It raises kanboard.ClientError for any API or network errors, giving you a single exception type to catch.

Use it for:

- Automate task creation and project setup from external systems or CI/CD pipelines.
- Build custom dashboards or reporting tools that pull project and task data from Kanboard.
- Synchronize Kanboard tasks with other tools or databases via periodic API calls.
- Write integration scripts that respond to events and update Kanboard state programmatically.
- Test Kanboard deployments or validate API behavior in automated test suites.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

A Python client library that wraps the Kanboard JSON-RPC API, allowing you to programmatically manage projects, tasks, and other Kanboard resources from Python code.

Yes. The package has no runtime dependencies, low install friction, active maintenance, a permissive MIT license, and zero known vulnerabilities. It directly solves the problem of programmatic Kanboard access for Python developers. Install it if you need to automate Kanboard workflows or integrate Kanboard into a larger Python application.

## Install

pip install kanboard
uv add kanboard
poetry add kanboard

## Installing kanboard

Before you install: Low friction installation with no runtime dependencies. The package is actively maintained, with a recent release and ongoing repository activity.

License in practice: MIT license is permissive and places minimal restrictions on use, modification, and distribution in both open-source and proprietary contexts.

Quickstart:

pip install kanboard

import kanboard

with kanboard.Client("http://localhost/jsonrpc.php", "admin", "secret") as kb:
    project_id = kb.create_project(name="My project")
    task_id = kb.create_task(project_id=project_id, title="My task")

Requires Python >= 3.9 and a running Kanboard instance with network access to its JSON-RPC endpoint.

Verify before relying:

- Whether the client supports all current Kanboard API methods or only a subset of the documented procedures.
- Performance characteristics and rate-limiting behavior when making bulk API calls.
- Compatibility with specific Kanboard server versions beyond the general API documentation.

## Package facts

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

## Tags

kanboard api client, kanboard python library, kanboard task management, kanboard project automation, kanboard jsonrpc client, kanboard integration python, api-client, task-management, automation

[View on SkillFed](https://skillfed.io/packages/kanboard) · [View on PyPI](https://pypi.org/project/kanboard/)