Google Tasks
Set up the Google Tasks source connector using this guide and reference information.
API documentation
Visit https://developers.google.com/tasks/reference/rest for API documentation.
Authentication
The Google Tasks API accepts only OAuth 2.0 user credentials. It doesn’t support API keys. You can choose from two authentication options:
- Authenticate via Google (OAuth) (recommended): provide a Google OAuth 2.0 Client ID, Client Secret and Refresh Token. The connector exchanges the refresh token for a new access token at the start of every sync. This process keeps scheduled syncs working.
- Access Token: provide a raw Google OAuth 2.0 access token. Google access tokens expire after about one hour, so use this option only for one-off tests.
Connections created before version 0.0.71 used one api_key field containing an access token. These configurations automatically migrate to the Access Token option. That token has long expired. To resume syncing, edit the source and switch to the Authenticate via Google (OAuth) option.
Get OAuth credentials
- Visit google cloud
https://console.cloud.google.com/apis/api/tasks.googleapis.com/metricsand enable the Tasks API service. - Go to the consent screen
https://console.cloud.google.com/apis/credentials/consentand add your email as a test user. - Visit
https://console.cloud.google.com/apis/credentialsand create new credentials for OAuth 2.0. Copy the client id and client secret. - Get a refresh token for your account, for example with Postman:
- Add callback url
https://oauth.pstmn.io/v1/callbackwhen creating the credentials. - Open a new tab in the postman client and set authorization to OAuth 2.0.
- Set scope as
https://www.googleapis.com/auth/tasks.readonly. - Set access token URL as
https://oauth2.googleapis.com/token. - Set auth URL as
https://accounts.google.com/o/oauth2/v2/auth. Add the advanced parametersaccess_type=offlineandprompt=consentso a refresh token is returned. - Click
Get New Access Tokenand authorise through your google account. - Copy the resulting refresh token, client id and client secret into the connector configuration.
- Add callback url
Configuration
| Input | Type | Description | Default Value |
|---|---|---|---|
credentials | object | Authentication. Credentials for connecting to the Google Tasks API. | |
credentials.client_id | string | Client ID of the Google OAuth 2.0 application (OAuth option). | |
credentials.client_secret | string | Client Secret of the Google OAuth 2.0 application (OAuth option). | |
credentials.refresh_token | string | Refresh token obtained with the https://www.googleapis.com/auth/tasks.readonly scope (OAuth option). | |
credentials.access_token | string | Short-lived Google OAuth 2.0 access token (Access Token option). | |
start_date | string | Start date. Only task lists and tasks last updated on or after this date are synced. | |
records_limit | string | Records Limit. The maximum number of records to be returned per request | 50 |
Streams
| Stream Name | Primary Key | Pagination | Supports Full Sync | Supports Incremental |
|---|---|---|---|---|
| tasks | id | DefaultPaginator | ✅ | ✅ |
| lists_tasks | id | DefaultPaginator | ✅ | ✅ |
IP allow list
Add the Airbyte Cloud IP addresses to your allow list if you use Airbyte Cloud and your organisation restricts access to specific IPs.
Changelog
Expand to review
| Version | Date | Pull Request | Subject |
|---|---|---|---|
| 0.0.77 | 2026-11-10 | 91567 | Update dependencies |
| 0.0.76 | 2026-11-04 | 90385 | Simplify rate-limit error handling configuration with no change in retry behavior |
| 0.0.75 | 2026-11-03 | 90621 | Update dependencies |
| 0.0.74 | 2026-10-27 | 89920 | Update dependencies |
| 0.0.73 | 2026-10-20 | 89257 | Update dependencies |
| 0.0.72 | 2026-10-13 | 88642 | Update dependencies |
| 0.0.71 | 2026-10-07 | 88270 | Add OAuth (refresh token) authentication so access tokens are refreshed every sync; migrate legacy api_key configs |
| 0.0.70 | 2026-10-06 | 87907 | Update dependencies |
| 0.0.69 | 2026-09-29 | 87191 | Update dependencies |
| 0.0.68 | 2026-09-22 | 86671 | Update dependencies |
| 0.0.67 | 2026-09-15 | 86084 | Update dependencies |
| 0.0.66 | 2026-09-08 | 85510 | Update dependencies |
| 0.0.65 | 2026-08-18 | 84621 | Update dependencies |
| 0.0.64 | 2026-08-11 | 83974 | Update dependencies |
| 0.0.63 | 2026-08-04 | 83480 | Update dependencies |
| 0.0.62 | 2026-07-28 | 82963 | Update dependencies |
| 0.0.61 | 2026-07-21 | 82438 | Update dependencies |
| 0.0.60 | 2026-07-14 | 81853 | Update dependencies |
| 0.0.59 | 2026-06-30 | 81100 | Update dependencies |
| 0.0.58 | 2026-06-23 | 80492 | Update dependencies |
| 0.0.57 | 2026-06-16 | 79891 | Update dependencies |
| 0.0.56 | 2026-06-09 | 79349 | Update dependencies |
| 0.0.55 | 2026-06-02 | 78747 | Update dependencies |
| 0.0.54 | 2026-04-28 | 77291 | Update dependencies |
| 0.0.53 | 2026-04-21 | 76620 | Update dependencies |
| 0.0.52 | 2026-03-31 | 75704 | Update dependencies |
| 0.0.51 | 2026-03-24 | 75356 | Update dependencies |
| 0.0.50 | 2026-03-10 | 74679 | Update dependencies |
| 0.0.49 | 2026-03-03 | 74168 | Update dependencies |
| 0.0.48 | 2026-02-10 | 73121 | Update dependencies |
| 0.0.47 | 2026-02-03 | 72659 | Update dependencies |
| 0.0.46 | 2026-01-20 | 71901 | Update dependencies |
| 0.0.45 | 2026-01-14 | 71719 | Update dependencies |
| 0.0.44 | 2025-12-18 | 70507 | Update dependencies |
| 0.0.43 | 2025-11-25 | 70046 | Update dependencies |
| 0.0.42 | 2025-11-18 | 69383 | Update dependencies |
| 0.0.41 | 2025-10-29 | 68791 | Update dependencies |
| 0.0.40 | 2025-10-21 | 68229 | Update dependencies |
| 0.0.39 | 2025-10-14 | 67878 | Update dependencies |
| 0.0.38 | 2025-10-07 | 67397 | Update dependencies |
| 0.0.37 | 2025-09-30 | 66403 | Update dependencies |
| 0.0.36 | 2025-09-09 | 65901 | Update dependencies |
| 0.0.35 | 2025-08-23 | 65308 | Update dependencies |
| 0.0.34 | 2025-08-09 | 64634 | Update dependencies |
| 0.0.33 | 2025-08-02 | 64184 | Update dependencies |
| 0.0.32 | 2025-07-26 | 63874 | Update dependencies |
| 0.0.31 | 2025-07-19 | 63502 | Update dependencies |
| 0.0.30 | 2025-07-12 | 63099 | Update dependencies |
| 0.0.29 | 2025-07-05 | 62639 | Update dependencies |
| 0.0.28 | 2025-06-21 | 61840 | Update dependencies |
| 0.0.27 | 2025-06-14 | 60652 | Update dependencies |
| 0.0.26 | 2025-05-10 | 59815 | Update dependencies |
| 0.0.25 | 2025-05-03 | 59281 | Update dependencies |
| 0.0.24 | 2025-04-26 | 58757 | Update dependencies |
| 0.0.23 | 2025-04-19 | 58209 | Update dependencies |
| 0.0.22 | 2025-04-12 | 57747 | Update dependencies |
| 0.0.21 | 2025-04-05 | 57032 | Update dependencies |
| 0.0.20 | 2025-03-29 | 56682 | Update dependencies |
| 0.0.19 | 2025-03-22 | 56038 | Update dependencies |
| 0.0.18 | 2025-03-08 | 55482 | Update dependencies |
| 0.0.17 | 2025-03-01 | 54781 | Update dependencies |
| 0.0.16 | 2025-02-22 | 54296 | Update dependencies |
| 0.0.15 | 2025-02-15 | 53794 | Update dependencies |
| 0.0.14 | 2025-02-08 | 53310 | Update dependencies |
| 0.0.13 | 2025-02-01 | 52863 | Update dependencies |
| 0.0.12 | 2025-01-25 | 52372 | Update dependencies |
| 0.0.11 | 2025-01-18 | 51805 | Update dependencies |
| 0.0.10 | 2025-01-11 | 51191 | Update dependencies |
| 0.0.9 | 2024-12-28 | 50647 | Update dependencies |
| 0.0.8 | 2024-12-21 | 50091 | Update dependencies |
| 0.0.7 | 2024-12-14 | 49594 | Update dependencies |
| 0.0.6 | 2024-12-12 | 49223 | Update dependencies |
| 0.0.5 | 2024-12-11 | 48949 | Starting with this version, the Docker image is now rootless. Please note that this and future versions will not be compatible with Airbyte versions earlier than 0.64 |
| 0.0.4 | 2024-11-05 | 48366 | Revert to source-declarative-manifest v5.17.0 |
| 0.0.3 | 2024-11-05 | 47770 | Update dependencies |
| 0.0.2 | 2024-10-28 | 47550 | Update dependencies |
| 0.0.1 | 2024-09-12 | 45427 | Initial release by @btkcodedev via Connector Builder |