> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kiwifs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Airbyte import

> Sync data from Airbyte Docker connectors or Airbyte Cloud into markdown pages.

KiwiFS can drive **Airbyte** connectors for sources easier to configure through Airbyte than native importers.

<Info>
  Native `kiwifs import --from notion` remains the simplest path for one-shot imports. Use Airbyte when you need scheduled sync or Airbyte Cloud connections.
</Info>

## Two modes

<Tabs>
  <Tab title="Airbyte Docker">
    Local connector containers. Phase 1 sources routed through Docker today:

    | Source          | Connector                  |
    | --------------- | -------------------------- |
    | `firebase-rtdb` | Firebase Realtime Database |
    | `notion`        | Notion                     |
    | `airtable`      | Airtable                   |

    | Method | Path                                | Purpose                    |
    | ------ | ----------------------------------- | -------------------------- |
    | `POST` | `/api/kiwi/import/airbyte/spec`     | Connector specification    |
    | `POST` | `/api/kiwi/import/airbyte/check`    | Validate connection config |
    | `POST` | `/api/kiwi/import/airbyte/discover` | List streams for a source  |
  </Tab>

  <Tab title="Airbyte Cloud">
    Hosted workspace API with discover/check/sync flows.

    | Method | Path                                         | Purpose                  |
    | ------ | -------------------------------------------- | ------------------------ |
    | `POST` | `/api/kiwi/import/airbyte-cloud/check`       | Check cloud source       |
    | `POST` | `/api/kiwi/import/airbyte-cloud/discover`    | Discover streams         |
    | `GET`  | `/api/kiwi/import/airbyte-cloud/connections` | List connections         |
    | `POST` | `/api/kiwi/import/airbyte-cloud/sync`        | Trigger sync into KiwiFS |
  </Tab>
</Tabs>

## Configuration

```toml .kiwi/config.toml theme={null}
[import]
airbyte_api_key = "${AIRBYTE_API_KEY}"
airbyte_workspace_id = "${AIRBYTE_WORKSPACE_ID}"
```

<Note>
  Environment variables expand in TOML via `${VAR}` syntax.
</Note>

## Sync status

```bash theme={null}
curl 'http://localhost:3333/api/kiwi/import/sync/status'
```

Use with saved [import connections](/import/connections) when periodic sync is enabled.

## Firebase RTDB record explosion

When importing Firebase Realtime Database key/value records through Airbyte, KiwiFS **explodes** each record into its own markdown page instead of collapsing the entire snapshot into one file. This makes large RTDB trees searchable and linkable in your knowledge base.

## MCP

Agents can call **`kiwi_import`** with Airbyte-compatible source configuration. Available sources are listed by `GET /api/kiwi/import/sources`.

## Related documentation

<CardGroup cols={2}>
  <Card title="Import overview" icon="download" href="/import/overview">
    All 18+ import sources.
  </Card>

  <Card title="Import API" icon="arrows-rotate" href="/api/import-export">
    REST reference.
  </Card>

  <Card title="Connections" icon="plug" href="/import/connections">
    Saved connections and re-runs.
  </Card>
</CardGroup>