PHPackages                             fabian-beiner/todoist-php-api-library - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. fabian-beiner/todoist-php-api-library

ActiveLibrary[API Development](/categories/api)

fabian-beiner/todoist-php-api-library
=====================================

A PHP client library that provides a native interface to the official Todoist REST API.

v2.0.1(3y ago)4810.8k↑111.1%12[1 issues](https://github.com/FabianBeiner/Todoist-PHP-API-Library/issues)MITPHPPHP >=8.0CI failing

Since Dec 21Pushed 3y ago9 watchersCompare

[ Source](https://github.com/FabianBeiner/Todoist-PHP-API-Library)[ Packagist](https://packagist.org/packages/fabian-beiner/todoist-php-api-library)[ RSS](/packages/fabian-beiner-todoist-php-api-library/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (10)Dependencies (3)Versions (19)Used By (0)

[![GitHub tag (latest by date)](https://camo.githubusercontent.com/afd1c3e1f141298fb8b73a3d6483c50c7396bc5f1c87e638f718cb3cef406990/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f762f7461672f46616269616e4265696e65722f546f646f6973742d5048502d4150492d4c6962726172793f7374796c653d666c61742d737175617265)](https://camo.githubusercontent.com/afd1c3e1f141298fb8b73a3d6483c50c7396bc5f1c87e638f718cb3cef406990/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f762f7461672f46616269616e4265696e65722f546f646f6973742d5048502d4150492d4c6962726172793f7374796c653d666c61742d737175617265) [![GitHub stars](https://camo.githubusercontent.com/26b9f47f4dda9e4e0d8b08e414c36bfeb37b81988035b46aa43b4aaff9ad6cfb/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f73746172732f46616269616e4265696e65722f546f646f6973742d5048502d4150492d4c6962726172793f7374796c653d666c61742d737175617265)](https://github.com/FabianBeiner/Todoist-PHP-API-Library/stargazers) [![GitHub forks](https://camo.githubusercontent.com/764b0a393e63fc2ad03a5acf527929603ad53ade01e8e91d94e6feff8e182b05/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f666f726b732f46616269616e4265696e65722f546f646f6973742d5048502d4150492d4c6962726172793f7374796c653d666c61742d737175617265)](https://github.com/FabianBeiner/Todoist-PHP-API-Library/network) [![GitHub issues](https://camo.githubusercontent.com/45b219611afa98edbe20f49953bf87501fb3480d0d966a89c60e0b0a2bc7eff1/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6973737565732f46616269616e4265696e65722f546f646f6973742d5048502d4150492d4c6962726172793f7374796c653d666c61742d737175617265)](https://github.com/FabianBeiner/Todoist-PHP-API-Library/issues) [![GitHub license](https://camo.githubusercontent.com/4b2ea1ed538e3fc556b3b310fea31413b36cb070674915079b89d3e1e9fe7077/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f46616269616e4265696e65722f546f646f6973742d5048502d4150492d4c6962726172793f7374796c653d666c61742d737175617265)](https://github.com/FabianBeiner/Todoist-PHP-API-Library/blob/master/LICENSE) [![Codacy grade](https://camo.githubusercontent.com/80aee8622420161cbb6c07269a51c507a8555651e5f7c5bbcd25614e2bf9f9a2/68747470733a2f2f696d672e736869656c64732e696f2f636f646163792f67726164652f61386361643835336132623034316138393637353362346464613536353961643f7374796c653d666c61742d737175617265)](https://camo.githubusercontent.com/80aee8622420161cbb6c07269a51c507a8555651e5f7c5bbcd25614e2bf9f9a2/68747470733a2f2f696d672e736869656c64732e696f2f636f646163792f67726164652f61386361643835336132623034316138393637353362346464613536353961643f7374796c653d666c61742d737175617265) [![StyleCI Badge](https://camo.githubusercontent.com/637ec5dc54c3cda02bcf199ec67572ca36b6107df7dab5e48c1ae839ea3f8d01/68747470733a2f2f7374796c6563692e696f2f7265706f732f32383331333039372f736869656c643f7374796c653d666c61742d737175617265)](https://styleci.io/repos/28313097/)

PHP Client for Todoist
======================

[](#php-client-for-todoist)

**This repository contains a PHP client library that provides a native interface to the official [Todoist REST API (v2)](https://developer.todoist.com/rest/v2/).**

Requirements
------------

[](#requirements)

- [PHP](https://php.net/): >=8.0
- [Guzzle](https://github.com/guzzle/guzzle): ^7.5

Installation
------------

[](#installation)

The recommended way is using **[Composer](https://getcomposer.org/)**. If you don’t have Composer installed, follow the [installation instructions](https://getcomposer.org/doc/00-intro.md#installation-linux-unix-macos).

Once you have installed Composer, execute the following command in your project root to install this library:

```
composer require fabian-beiner/todoist-php-api-library
```

Finally, include the autoloader in your project:

```
require __DIR__ . '/vendor/autoload.php';
```

Usage
-----

[](#usage)

```
$Todoist = new FabianBeiner\Todoist\TodoistClient('YOUR_API_TOKEN');
```

[Please look at the Wiki of this project.](https://github.com/FabianBeiner/Todoist-PHP-API-Library/wiki) It contains a list of all available methods and related usage examples.

Obtain your API token
---------------------

[](#obtain-your-api-token)

[Click here](https://todoist.com/app/settings/integrations) to find your API token at the bottom of that page.

If the link doesn’t work, open the [Todoist web app](https://todoist.com/app/), click on your profile image/icon, select “Settings,” then “Integrations.”

Changelog
---------

[](#changelog)

👉 [CHANGELOG.md](https://github.com/FabianBeiner/Todoist-PHP-API-Library/blob/master/CHANGELOG.md)

Contributing
------------

[](#contributing)

I’d be happy if you contributed to this library. Please follow the existing coding style and use proper comments in your commit message. Thanks! 🙇

License
-------

[](#license)

👉 [LICENSE](https://github.com/FabianBeiner/Todoist-PHP-API-Library/blob/master/LICENSE)

Disclaimer
----------

[](#disclaimer)

The project is not created by, affiliated with, or supported by Doist. 😢

###  Health Score

43

—

FairBetter than 91% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity38

Limited adoption so far

Community20

Small or concentrated contributor base

Maturity77

Established project with proven stability

 Bus Factor1

Top contributor holds 77.7% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~172 days

Recently: every ~189 days

Total

18

Last Release

1236d ago

Major Versions

v0.8.2 → v1.0.02020-01-02

v1.1.1 → v2.0.02022-11-25

PHP version history (7 changes)v0.1.0PHP >=5.5.0

v0.3.0PHP >=5.5

v0.6.0PHP >=7.0

v0.8.1PHP >=7.1

v1.0.0PHP >=7.2

v1.1.1PHP >=7.4

v2.0.0PHP >=8.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/02e0c389f5aa8a48d680845f5ad5a7422afc6564684d91be5c1a34cfc2efbce1?d=identicon)[FabianBeiner](/maintainers/FabianBeiner)

---

Top Contributors

[![FabianBeiner](https://avatars.githubusercontent.com/u/86269?v=4)](https://github.com/FabianBeiner "FabianBeiner (122 commits)")[![Valkyrie00](https://avatars.githubusercontent.com/u/4854263?v=4)](https://github.com/Valkyrie00 "Valkyrie00 (16 commits)")[![balazscsaba2006](https://avatars.githubusercontent.com/u/1202594?v=4)](https://github.com/balazscsaba2006 "balazscsaba2006 (9 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (4 commits)")[![dvdheiden](https://avatars.githubusercontent.com/u/90568118?v=4)](https://github.com/dvdheiden "dvdheiden (4 commits)")[![GoldcarrotYamil](https://avatars.githubusercontent.com/u/17644997?v=4)](https://github.com/GoldcarrotYamil "GoldcarrotYamil (1 commits)")[![judzi](https://avatars.githubusercontent.com/u/7264588?v=4)](https://github.com/judzi "judzi (1 commits)")

---

Tags

apiapi-clientclientlibraryphpsdksdk-phptodoisttodoist-apitodoist-sdkphpapiclientsdklibraryapi clientsdk-phptodoisttodoist-apitodoist-sdk

###  Code Quality

TestsPHPUnit

Code StylePHP CS Fixer

### Embed Badge

![Health badge](/badges/fabian-beiner-todoist-php-api-library/health.svg)

```
[![Health](https://phpackages.com/badges/fabian-beiner-todoist-php-api-library/health.svg)](https://phpackages.com/packages/fabian-beiner-todoist-php-api-library)
```

###  Alternatives

[openai-php/laravel

OpenAI PHP for Laravel is a supercharged PHP API client that allows you to interact with the Open AI API

3.7k7.6M74](/packages/openai-php-laravel)[kunalvarma05/dropbox-php-sdk

Dropbox PHP API V2 SDK (Unofficial)

3633.0M18](/packages/kunalvarma05-dropbox-php-sdk)[resend/resend-php

Resend PHP library.

564.7M21](/packages/resend-resend-php)[checkout/checkout-sdk-php

Checkout.com SDK for PHP

553.3M7](/packages/checkout-checkout-sdk-php)[crowdin/crowdin-api-client

PHP client library for Crowdin API v2

611.5M5](/packages/crowdin-crowdin-api-client)[mozex/anthropic-laravel

Anthropic PHP for Laravel is a supercharged PHP API client that allows you to interact with the Anthropic API

71226.4k1](/packages/mozex-anthropic-laravel)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)