Skip to main content
KiwiFS can drive Airbyte connectors for sources easier to configure through Airbyte than native importers.
Native kiwifs import --from notion remains the simplest path for one-shot imports. Use Airbyte when you need scheduled sync or Airbyte Cloud connections.

​
Two modes

Local connector containers. Phase 1 sources routed through Docker today:
SourceConnector
firebase-rtdbFirebase Realtime Database
notionNotion
airtableAirtable
MethodPathPurpose
POST/api/kiwi/import/airbyte/specConnector specification
POST/api/kiwi/import/airbyte/checkValidate connection config
POST/api/kiwi/import/airbyte/discoverList streams for a source

​
Configuration

.kiwi/config.toml
[import]
airbyte_api_key = "${AIRBYTE_API_KEY}"
airbyte_workspace_id = "${AIRBYTE_WORKSPACE_ID}"
Environment variables expand in TOML via ${VAR} syntax.

​
Sync status

curl 'http://localhost:3333/api/kiwi/import/sync/status'
Use with saved 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.

Import overview

All 18+ import sources.

Import API

REST reference.

Connections

Saved connections and re-runs.
Last modified on May 23, 2026