airbyte-agent-airtable 0.1.4__tar.gz

airbyte_agent_airtable-0.1.4/.gitignore

@@ -0,0 +1,29 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+dist/
+build/
+.eggs/
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+
+# Virtual environments
+.venv/
+venv/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+
+# OS
+.DS_Store
+Thumbs.db
+
+.env
+configured_connectors.yaml

airbyte_agent_airtable-0.1.4/AUTH.md

@@ -0,0 +1,99 @@
+# Airtable authentication and configuration
+
+This page documents the authentication and configuration options for the Airtable agent connector.
+
+## Authentication
+
+### Open source execution
+
+In open source mode, you provide API credentials directly to the connector.
+
+#### OAuth
+This authentication method isn't available for this connector.
+
+#### Token
+
+`credentials` fields you need:
+
+| Field Name | Type | Required | Description |
+|------------|------|----------|-------------|
+| `personal_access_token` | `str` | Yes | Airtable Personal Access Token. See https://airtable.com/developers/web/guides/personal-access-tokens |
+
+Example request:
+
+```python
+from airbyte_agent_airtable import AirtableConnector
+from airbyte_agent_airtable.models import AirtableAuthConfig
+
+connector = AirtableConnector(
+    auth_config=AirtableAuthConfig(
+        personal_access_token="<Airtable Personal Access Token. See https://airtable.com/developers/web/guides/personal-access-tokens>"
+    )
+)
+```
+
+### Hosted execution
+
+In hosted mode, you first create a connector via the Airbyte API (providing your OAuth or Token credentials), then execute operations using either the Python SDK or API. If you need a step-by-step guide, see the [hosted execution tutorial](https://docs.airbyte.com/ai-agents/quickstarts/tutorial-hosted).
+
+#### OAuth
+This authentication method isn't available for this connector.
+
+#### Token
+Create a connector with Token credentials.
+
+
+`credentials` fields you need:
+
+| Field Name | Type | Required | Description |
+|------------|------|----------|-------------|
+| `personal_access_token` | `str` | Yes | Airtable Personal Access Token. See https://airtable.com/developers/web/guides/personal-access-tokens |
+
+Example request:
+
+
+```bash
+curl -X POST "https://api.airbyte.ai/v1/integrations/connectors" \
+  -H "Authorization: Bearer <SCOPED_TOKEN>" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "external_user_id": "<EXTERNAL_USER_ID>",
+    "connector_type": "Airtable",
+    "name": "My Airtable Connector",
+    "credentials": {
+      "personal_access_token": "<Airtable Personal Access Token. See https://airtable.com/developers/web/guides/personal-access-tokens>"
+    }
+  }'
+```
+
+#### Execution
+
+After creating the connector, execute operations using either the Python SDK or API.
+
+**Python SDK**
+
+```python
+from airbyte_agent_airtable import AirtableConnector
+
+connector = AirtableConnector(
+    external_user_id="<your_external_user_id>",
+    airbyte_client_id="<your-client-id>",
+    airbyte_client_secret="<your-client-secret>"
+)
+
+@agent.tool_plain # assumes you're using Pydantic AI
+@AirtableConnector.tool_utils
+async def airtable_execute(entity: str, action: str, params: dict | None = None):
+    return await connector.execute(entity, action, params or {})
+```
+
+**API**
+
+```bash
+curl -X POST 'https://api.airbyte.ai/api/v1/connectors/sources/<connector_id>/execute' \
+  -H 'Authorization: Bearer <SCOPED_TOKEN>' \
+  -H 'Content-Type: application/json' \
+  -d '{"entity": "<entity>", "action": "<action>", "params": {}}'
+```
+
+

airbyte_agent_airtable-0.1.4/CHANGELOG.md

@@ -0,0 +1,26 @@
+# Airtable changelog
+
+## [0.1.4] - 2026-01-30
+- Updated connector definition (YAML version 1.0.2)
+- Source commit: b184da3e
+- SDK version: 0.1.0
+
+## [0.1.3] - 2026-01-30
+- Updated connector definition (YAML version 1.0.2)
+- Source commit: 5f65d643
+- SDK version: 0.1.0
+
+## [0.1.2] - 2026-01-30
+- Updated connector definition (YAML version 1.0.1)
+- Source commit: 5b20f488
+- SDK version: 0.1.0
+
+## [0.1.1] - 2026-01-30
+- Updated connector definition (YAML version 1.0.1)
+- Source commit: a3729d85
+- SDK version: 0.1.0
+
+## [0.1.0] - 2026-01-29
+- Updated connector definition (YAML version 1.0.1)
+- Source commit: 7dbd4946
+- SDK version: 0.1.0

airbyte_agent_airtable-0.1.4/PKG-INFO

@@ -0,0 +1,140 @@
+Metadata-Version: 2.4
+Name: airbyte-agent-airtable
+Version: 0.1.4
+Summary: Airbyte Airtable Connector for AI platforms
+Project-URL: Homepage, https://github.com/airbytehq/airbyte-agent-connectors
+Project-URL: Documentation, https://docs.airbyte.com/ai-agents/
+Project-URL: Repository, https://github.com/airbytehq/airbyte-agent-connectors
+Project-URL: Issues, https://github.com/airbytehq/airbyte-agent-connectors/issues
+Author-email: Airbyte <contact@airbyte.io>
+License: Elastic-2.0
+Keywords: agent,ai,airbyte,airtable,api,connector,data-integration,llm,mcp
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: Other/Proprietary License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: >=3.13
+Requires-Dist: httpx>=0.24.0
+Requires-Dist: jinja2>=3.0.0
+Requires-Dist: jsonpath-ng>=1.6.1
+Requires-Dist: jsonref>=1.1.0
+Requires-Dist: opentelemetry-api>=1.37.0
+Requires-Dist: opentelemetry-sdk>=1.37.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: segment-analytics-python>=2.2.0
+Description-Content-Type: text/markdown
+
+# Airtable agent connector
+
+Airtable is a cloud-based platform that combines the simplicity of a spreadsheet with the 
+power of a database. This connector provides access to bases, tables, and records for 
+data analysis and workflow automation.
+
+
+## Example questions
+
+The Airtable connector is optimized to handle prompts like these.
+
+- List all my Airtable bases
+- What tables are in base appXXX?
+- Show me the schema for tables in base appXXX
+- List records from table tblXXX in base appXXX
+- Get record recXXX from table tblXXX in base appXXX
+- What fields are in table tblXXX?
+- List records where Status is 'Done' in table tblXXX
+
+## Unsupported questions
+
+The Airtable connector isn't currently able to handle prompts like these.
+
+- Create a new record in Airtable
+- Update a record in Airtable
+- Delete a record from Airtable
+- Create a new table
+- Modify table schema
+
+## Installation
+
+```bash
+uv pip install airbyte-agent-airtable
+```
+
+## Usage
+
+Connectors can run in open source or hosted mode.
+
+### Open source
+
+In open source mode, you provide API credentials directly to the connector.
+
+```python
+from airbyte_agent_airtable import AirtableConnector
+from airbyte_agent_airtable.models import AirtableAuthConfig
+
+connector = AirtableConnector(
+    auth_config=AirtableAuthConfig(
+        personal_access_token="<Airtable Personal Access Token. See https://airtable.com/developers/web/guides/personal-access-tokens>"
+    )
+)
+
+@agent.tool_plain # assumes you're using Pydantic AI
+@AirtableConnector.tool_utils
+async def airtable_execute(entity: str, action: str, params: dict | None = None):
+    return await connector.execute(entity, action, params or {})
+```
+
+### Hosted
+
+In hosted mode, API credentials are stored securely in Airbyte Cloud. You provide your Airbyte credentials instead. 
+
+This example assumes you've already authenticated your connector with Airbyte. See [Authentication](AUTH.md) to learn more about authenticating. If you need a step-by-step guide, see the [hosted execution tutorial](https://docs.airbyte.com/ai-agents/quickstarts/tutorial-hosted).
+
+```python
+from airbyte_agent_airtable import AirtableConnector
+
+connector = AirtableConnector(
+    external_user_id="<your_external_user_id>",
+    airbyte_client_id="<your-client-id>",
+    airbyte_client_secret="<your-client-secret>"
+)
+
+@agent.tool_plain # assumes you're using Pydantic AI
+@AirtableConnector.tool_utils
+async def airtable_execute(entity: str, action: str, params: dict | None = None):
+    return await connector.execute(entity, action, params or {})
+```
+
+## Full documentation
+
+### Entities and actions
+
+This connector supports the following entities and actions. For more details, see this connector's [full reference documentation](REFERENCE.md).
+
+| Entity | Actions |
+|--------|---------|
+| Bases | [List](./REFERENCE.md#bases-list) |
+| Tables | [List](./REFERENCE.md#tables-list) |
+| Records | [List](./REFERENCE.md#records-list), [Get](./REFERENCE.md#records-get) |
+
+
+### Authentication and configuration
+
+For all authentication and configuration options, see the connector's [authentication documentation](AUTH.md).
+
+### Airtable API docs
+
+See the official [Airtable API reference](https://airtable.com/developers/web/api/introduction).
+
+## Version information
+
+- **Package version:** 0.1.4
+- **Connector version:** 1.0.2
+- **Generated with Connector SDK commit SHA:** b184da3e22ef8521d2eeebf3c96a0fe8da2424f5
+- **Changelog:** [View changelog](https://github.com/airbytehq/airbyte-agent-connectors/blob/main/connectors/airtable/CHANGELOG.md)

airbyte_agent_airtable-0.1.4/README.md

@@ -0,0 +1,107 @@
+# Airtable agent connector
+
+Airtable is a cloud-based platform that combines the simplicity of a spreadsheet with the 
+power of a database. This connector provides access to bases, tables, and records for 
+data analysis and workflow automation.
+
+
+## Example questions
+
+The Airtable connector is optimized to handle prompts like these.
+
+- List all my Airtable bases
+- What tables are in base appXXX?
+- Show me the schema for tables in base appXXX
+- List records from table tblXXX in base appXXX
+- Get record recXXX from table tblXXX in base appXXX
+- What fields are in table tblXXX?
+- List records where Status is 'Done' in table tblXXX
+
+## Unsupported questions
+
+The Airtable connector isn't currently able to handle prompts like these.
+
+- Create a new record in Airtable
+- Update a record in Airtable
+- Delete a record from Airtable
+- Create a new table
+- Modify table schema
+
+## Installation
+
+```bash
+uv pip install airbyte-agent-airtable
+```
+
+## Usage
+
+Connectors can run in open source or hosted mode.
+
+### Open source
+
+In open source mode, you provide API credentials directly to the connector.
+
+```python
+from airbyte_agent_airtable import AirtableConnector
+from airbyte_agent_airtable.models import AirtableAuthConfig
+
+connector = AirtableConnector(
+    auth_config=AirtableAuthConfig(
+        personal_access_token="<Airtable Personal Access Token. See https://airtable.com/developers/web/guides/personal-access-tokens>"
+    )
+)
+
+@agent.tool_plain # assumes you're using Pydantic AI
+@AirtableConnector.tool_utils
+async def airtable_execute(entity: str, action: str, params: dict | None = None):
+    return await connector.execute(entity, action, params or {})
+```
+
+### Hosted
+
+In hosted mode, API credentials are stored securely in Airbyte Cloud. You provide your Airbyte credentials instead. 
+
+This example assumes you've already authenticated your connector with Airbyte. See [Authentication](AUTH.md) to learn more about authenticating. If you need a step-by-step guide, see the [hosted execution tutorial](https://docs.airbyte.com/ai-agents/quickstarts/tutorial-hosted).
+
+```python
+from airbyte_agent_airtable import AirtableConnector
+
+connector = AirtableConnector(
+    external_user_id="<your_external_user_id>",
+    airbyte_client_id="<your-client-id>",
+    airbyte_client_secret="<your-client-secret>"
+)
+
+@agent.tool_plain # assumes you're using Pydantic AI
+@AirtableConnector.tool_utils
+async def airtable_execute(entity: str, action: str, params: dict | None = None):
+    return await connector.execute(entity, action, params or {})
+```
+
+## Full documentation
+
+### Entities and actions
+
+This connector supports the following entities and actions. For more details, see this connector's [full reference documentation](REFERENCE.md).
+
+| Entity | Actions |
+|--------|---------|
+| Bases | [List](./REFERENCE.md#bases-list) |
+| Tables | [List](./REFERENCE.md#tables-list) |
+| Records | [List](./REFERENCE.md#records-list), [Get](./REFERENCE.md#records-get) |
+
+
+### Authentication and configuration
+
+For all authentication and configuration options, see the connector's [authentication documentation](AUTH.md).
+
+### Airtable API docs
+
+See the official [Airtable API reference](https://airtable.com/developers/web/api/introduction).
+
+## Version information
+
+- **Package version:** 0.1.4
+- **Connector version:** 1.0.2
+- **Generated with Connector SDK commit SHA:** b184da3e22ef8521d2eeebf3c96a0fe8da2424f5
+- **Changelog:** [View changelog](https://github.com/airbytehq/airbyte-agent-connectors/blob/main/connectors/airtable/CHANGELOG.md)