NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI · #5484 most downloaded on PyPI
PyAirbyte
Last release today
03 Oct 2026
Ships on a steady schedule
a new release about every 2 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
3 years old
188 releases · first in 2024
Annotate local tools with requires_client_filesystem (https://github.com/airbytehq/PyAirbyte/pull/1052) 1e2d7d8
requires_client_filesystem (https://github.com/airbytehq/PyAirbyte/pull/1052) 1e2d7d8See also: Full Release Notes (v0.x family) | Full Changelog (v0.48.0...v0.49.0) <!-- Release drafted at 2026-06-29 11:42am Pacific from https://github.com/airbytehq/PyAirbyte/commit/1e2d7d88d920620ef5881bd6d9217a965df8f964 -->
Add OIDC auth, HTTP entry point, and Dockerfile for hosted deployment (https://github.com/airbytehq/PyAirbyte/pull/1046) ad6b43f
Full Changelog: https://github.com/airbytehq/PyAirbyte/compare/v0.47.1...v0.48.0
One column per month.
Widen cryptography constraint and bump CDK to 7.21.1 (https://github.com/airbytehq/PyAirbyte/pull/1044) c5d5a58
Full Changelog: https://github.com/airbytehq/PyAirbyte/compare/v0.47.0...v0.47.1
Add workspace sync status UI tool (https://github.com/airbytehq/PyAirbyte/pull/1043) 246b0cd
show_connection_sync_history interactive UI tool (https://github.com/airbytehq/PyAirbyte/pull/1042) da03d99Full Changelog: https://github.com/airbytehq/PyAirbyte/compare/v0.46.0...v0.47.0
Nothing published for this version
Nothing published for this version
Add workspace create, delete, and rename support (https://github.com/airbytehq/PyAirbyte/pull/1032) 8427840
CloudClient, move CloudOrganization to dedicated cloud.organizations module (https://github.com/airbytehq/PyAirbyte/pull/1030) 8a2b207list operations (https://github.com/airbytehq/PyAirbyte/pull/1024) 70a7d82Full Changelog: https://github.com/airbytehq/PyAirbyte/compare/v0.45.0...v0.46.0
Normalize state and catalog to Airbyte protocol format by default (https://github.com/airbytehq/PyAirbyte/pull/1017) 8fb66f2
Full Changelog: https://github.com/airbytehq/PyAirbyte/compare/v0.44.1...v0.45.0
Upgrade fastmcp dependency from v2 to v3 (https://github.com/airbytehq/PyAirbyte/pull/1009) ce1a589
Full Changelog: https://github.com/airbytehq/PyAirbyte/compare/v0.44.0...v0.44.1
Add preflight check to destination smoke test tool (https://github.com/airbytehq/PyAirbyte/pull/1007) 3873093
Full Changelog: https://github.com/airbytehq/PyAirbyte/compare/v0.43.1...v0.44.0
Download components.zip instead of components.py from registry (https://github.com/airbytehq/PyAirbyte/pull/1005) 65e1c03
Full Changelog: https://github.com/airbytehq/PyAirbyte/compare/v0.43.0...v0.43.1
Add destination readback introspection for smoke tests (https://github.com/airbytehq/PyAirbyte/pull/1000) 3ab17f9
Full Changelog: https://github.com/airbytehq/PyAirbyte/compare/v0.42.0...v0.43.0
Add 7 new smoke test scenarios for improved destination coverage (https://github.com/airbytehq/PyAirbyte/pull/1002) 9d9e91b
Full Changelog: https://github.com/airbytehq/PyAirbyte/compare/v0.41.0...v0.42.0
Add namespace support to destination smoke tests (https://github.com/airbytehq/PyAirbyte/pull/999) a8666b2
Full Changelog: https://github.com/airbytehq/PyAirbyte/compare/v0.40.0...v0.41.0
Add destination-smoke-test command and MCP tool (https://github.com/airbytehq/PyAirbyte/pull/998) 00ab7ca
Full Changelog: https://github.com/airbytehq/PyAirbyte/compare/v0.39.0...v0.40.0
Add support for reading Connector Builder draft manifests (https://github.com/airbytehq/PyAirbyte/pull/992) 71597ca
source-smoke-test CLI (https://github.com/airbytehq/PyAirbyte/pull/996) 803fc93Full Changelog: https://github.com/airbytehq/PyAirbyte/compare/v0.38.0...v0.39.0
Add connection state and catalog management to CloudConnection (https://github.com/airbytehq/PyAirbyte/pull/975) e48484f
Full Changelog: https://github.com/airbytehq/PyAirbyte/compare/v0.37.0...v0.38.0
Add job_type filtering support to list_cloud_sync_jobs (https://github.com/airbytehq/PyAirbyte/pull/974) 2ea8876
job_type filtering support to list_cloud_sync_jobs (https://github.com/airbytehq/PyAirbyte/pull/974) 2ea8876billing_status, subscription_status, and is_account_locked to check_airbyte_cloud_workspace MCP tool (https://github.com/airbytehq/PyAirbyte/pull/965) cd5e6a0<details> <summary>6 changes</summary>
Full Changelog: https://github.com/airbytehq/PyAirbyte/compare/v0.36.1...v0.37.0
fix release versioning by using UV_DYNAMIC_VERSIONING_BYPASS (https://github.com/airbytehq/PyAirbyte/pull/952) 864ae43
<details> <summary>3 changes</summary>
Full Changelog: https://github.com/airbytehq/PyAirbyte/compare/v0.36.0...v0.36.1
chore: Bump DuckDB versions to 1.4.x and duckdb-engine to 0.17.x
feat(mcp): Add get\_custom\_source\_definition tool to retrieve connector builder manifests
feat: Add MCP tool and Python API for connection enable/disable and scheduling @aaronsteers
feat(cloud): Add workspace validation to CloudConnection
fix: Normalize API URLs to handle trailing slashes in Config API resolution @[devin-ai-integration[bot]]
feat(mcp): Add new AIRBYTE_CLOUD_CONFIG_API_URL environment variable
AIRBYTE_CLOUD_CONFIG_API_URL environment variable (#920)SyncMode.full_refresh when force_full_refresh=True (#899)Nothing published for this version
fix: Use Pydantic exclude_none=True to omit null namespace fields from catalog serialization
exclude_none=True to omit null namespace fields from catalog serialization (#825)Nothing published for this version
Nothing published for this version
feat(cloud): Add CloudWorkspace.from_env() classmethod
CloudWorkspace.from_env() classmethod (#909)CloudClientConfig class and bearer token authentication support (#916)/prerelease slash command for PyPI prereleases (#910)feat(cloud): Add CloudConnection methods: get_state_artifacts() and get_catalog_artifact()
CloudConnection methods: get_state_artifacts() and get_catalog_artifact() (#906)get_connection_artifact MCP tool for retrieving state and catalog artifacts (#906)Nothing published for this version
Nothing published for this version
fix(mcp): The check workspace tool should not fail when missing organization permissions @aaronsteers
feat: Add capability to set testing values on custom connector projects in Builder UI
pytz.utc with datetime.timezone.utc (#887) - Thanks, @bosper351!fix(mcp): Change run_cloud_sync tool defaults to wait=False
run_cloud_sync tool defaults to wait=False (#892)AIRBYTE_MCP_DOMAINS and AIRBYTE_MCP_DOMAINS_DISABLED env vars (#890)feat(mcp): Add pagination parameters to get_cloud_sync_logs tool
get_cloud_sync_logs tool (#888)list_deployed_cloud_connections (#882)list_cloud_workspaces and describe_cloud_organization tools (#883)feat: allow cloud deletes for all object types (with name-based safety protections)
InstallType.ANY and InstallType.INSTALLABLE enum values (#864)feat(mcp): Add optional workspace\_id parameter to cloud tools with conditional schema hiding
feat: Add names and URLs to MCP Cloud list tools outputs, eliminating the need to make subsequent tool calls to retrieve object names
list tools outputs, eliminating the need to make subsequent tool calls to retrieve object names (#874)max_items_limit and name_contains to MCP Cloud list tools (#874)The airbyte.sources.registry module has been moved to airbyte.registry, while keeping the legacy imports working to not break existing dependencies
airbyte.sources.registry module has been moved to airbyte.registry, while keeping the legacy imports working to not break existing dependenciesget_api_docs_urls tool with data.externalDocumentationUrls support (#858)get_connector_version_history tool to registry domain (#857)ci: fix lint issue @aaronsteers
set_cloud_connection_table_prefix tool within safe mode @aaronsteers (#847)fix(mcp): MCP safe mode should use runtime checks instead of tool filtering
feat: Enable AIRBYTE_CLOUD_MCP_SAFE_MODE by default and add section to MCP docs to explain these modes
AIRBYTE_CLOUD_MCP_SAFE_MODE by default and add section to MCP docs to explain these modes (#845)feat: Add interfaces for editing cloud source, destination, and connection configs
feat(mcp): Implement decorator-based safe mode filtering for Cloud ops tools
chore: Bump airbyte-cdk to 7.3.9
feat: Add safe_mode to custom connector definition deletion @aaronsteers
safe_mode to custom connector definition deletion @aaronsteers (#831)feat: Add YAML custom connector publishing
feat: Add time_to_first_record metric and adjusted performance stats
time_to_first_record metric and adjusted performance stats (#826)fix: store timestamps with timezone (#814) - _Thanks, @uptickmetachu!_
0.53.0 (#815)fix(cache): Properly dispose DuckDB connections to prevent file locking
docs(mcp): improve MCP docs including auto-generated pdocs @aaronsteers
feat(mcp): Add manifest_path parameter to local operations tools
manifest_path parameter to local operations tools (#800)feat: add list secret names tool and api for dotenv files @aaronsteers
feat(cloud): Add ability to view Cloud sync logs, including SyncAttempt abstraction for fetching job attempts
SyncAttempt abstraction for fetching job attempts (#781)name attribute for cloud objects: CloudConnection, CloudSource, and CloudDestination (#782)chore: bump to poetry 2.2.0 @aaronsteers
anyOf in MCP tool args @aaronsteers (#794)meta and telemetry modules, auto-register .envrc files as secret managers @aaronsteers (#790)mcp-tool-test Poe task @aaronsteers (#789)feat(mcp): add Airbyte Cloud MCP tools: Deploy, Sync, and List @aaronsteers
feat: add DEFAULT_INSTALL_DIR and DEFAULT_PROJECT_DIR inputs to the `constants` module
DEFAULT_INSTALL_DIR and DEFAULT_PROJECT_DIR inputs to the constants module (#763)yaml, python, docker, or auto) (#761)manifest_url to get_connector_info tool (#742)config parameter into config and config_file for better MCP client interoperability (#762)uv version requirement for broader compatibility with other tools (#777) - Thanks, @bosper351!!<details><summary>Show/Hide More Details</summary>
chore: bump airbyte-cdk to latest version (6.61.6) (#768)
chore: replace maintenance PATs with octavia-bot GitHub App authentication (#773)
Chore(deps): Bump amannn/action-semantic-pull-request from 5 to 6 @dependabot[bot] (#755)
Chore(deps): Bump actions/checkout from 4 to 5 @dependabot[bot] (#756)
Chore(deps): Bump actions/upload-pages-artifact from 3 to 4 @dependabot[bot] (#760)
Chore(deps): Bump pypa/gh-action-pypi-publish from 1.12.2 to 1.13.0 @dependabot[bot] (#775)
chore: fix community welcome message permissions (#778)
test: xfail cloud tests with permission errors (#765)
chore: revert dummy change (#758)
feat: Migrate workflows to use resolve-vars-action@v0 (#754)
ci: skip integration tests on Windows to reduce CI timeout (#779)
ci: Add GitHub action linting workflow (#774)
</details>
PyAirbyte v0.29 introduces powerful new features, including MCP tools targeted to LLM use cases, the ability to "preview" data from multiple streams s
PyAirbyte v0.29 introduces powerful new features, including MCP tools targeted to LLM use cases, the ability to "preview" data from multiple streams simultaneously, faster connector installs by leveraging the powerful uv tool, and the ability to mix-and-match connectors' Python versions within the same environment.
We're now also actively requesting feedback for the new experimental MCP features. You can share feedback in the GitHub Discussion here and in the #pyairbyte Slack channel.
Source.print_stream_previews() and Source.get_stream_previews() (#725)pip with uv for connector installations, resulting in dramatically faster connector installation (#730)use_python arg for get_source() and get_destination() (#730)use_python arg, even for Python versions not yet installed on the system (#730)list_connectors - List available Airbyte connectors with optional filtering by type (source/destination), install types (python, yaml, java, docker), or keywordsget_connector_info - Get documentation URL and information for a specific connectorlist_connector_config_secrets - List available config secret names for a given connectorvalidate_connector_config - Validate a connector configurationlist_source_streams - List all streams available in a source connectorget_source_stream_json_schema - Get the JSON schema for a specific stream in a source connectorget_stream_previews - Get sample records (previews) from streams in a source connectorread_source_stream_records - Read records from a specific source streamdescribe_default_cache - Describe the currently configured default cache (typically DuckDB)list_cached_streams - List all streams available in the default cachesync_source_to_cache - Run a sync from a source connector to the default DuckDB cacherun_sql_query - Run SQL queries against the default cache<details><summary>Show/Hide Details</summary>
uvx installation examples (#721)</details>
Your coding agent can read these notes before it upgrades. Set up the MCP server →