Hackathon [Feature]: Add Xero data-source connector
Author: NMZivkovicCreated Aug 28, 2026Updated Sep 12, 2026
LabelsenhancementINTEGRATIONShackathon
Problem Statement
cognee has five data-source connectors today (confluence, gmail, google-drive, notion, slack) against roughly 120 planned. Data sources are the thinnest surface in the project.
Xero is on the roadmap and has no connector.
Proposed Solution
Add a xero connector under packages/connector/xero/ in cognee-community, following the shape of the five existing connectors.
- Auth: OAuth 2.0
- Ingest: invoices, contacts, and notes
- Incremental sync:
If-Modified-Sinceheader - Forget-on-delete: deleting upstream must remove the record from the graph on the next sync
Watch out for
Tokens expire in 30 minutes and refresh handling is mandatory, not optional.
Package layout to follow
packages/connector/xero/
├── README.md
├── cognee_community_connector_xero/
│ ├── __init__.py
│ └── xero.py
├── examples/
├── tests/
└── pyproject.tomlRead packages/connector/notion/ first — it is the closest working reference.
Acceptance Criteria
- A user connects via OAuth 2.0 and selects what to ingest
- Selected content is ingested and searchable in cognee
- Incremental sync picks up only what changed since the last run
- Deleting the source upstream removes it from the graph on the next sync
- README with setup steps and a runnable example under
examples/ - Tests covering the ingest path and the incremental cursor
Context
Part of the cognee hackathon connector push. Difficulty: Advanced (H) — enterprise-gated account or a legacy API — claim only if you already have access
Source: topoteretes/cognee