Stateful docs
Building your context

Connect Sources

Pull in your data so Stateful can build an accurate model of who you are.

Stateful builds your knowledge graph from the sources you connect. The more you connect, the richer the context — and you stay in control of what goes in.

How to connect

  1. Open Stateful and click Add data sources on your Context page.
  2. Pick the source you want to add.
  3. Depending on the source, you'll either authorize an OAuth flow, turn on a local source in the desktop app, or upload an export file (see below).
  4. Stateful runs an initial sync in the background. Depending on the source, this can take a few minutes.

Cloud connectors (one-click)

These connect straight from the Connections screen — authorize once and Stateful keeps them synced.

Work & productivity

  • Google — Gmail, Calendar, Contacts, Photos
  • Microsoft — Outlook mail, Calendar, OneDrive
  • Slack
  • Notion
  • Linear
  • Todoist
  • Discord

Code

  • GitHub — repos, issues, PRs, and the code you've authored
  • GitLab — the same signal from your GitLab account

Health & activity

  • Strava — workouts and activity history
  • Oura — sleep, readiness, and activity

On your Mac (desktop app)

These read data that lives on your computer. They need the Stateful desktop app and macOS Full Disk Access — nothing leaves your machine unless you turn it on.

  • iMessage — your message history
  • Apple Notes and Apple Contacts
  • Safari and Chrome — browsing history
  • Local Codebase — your project files
  • Cursor and Claude Code — your AI coding sessions

AI chat history (file import)

Export your chat history from ChatGPT, Claude, or Gemini and upload it — Stateful extracts the durable facts and drops the rest.

What happens after connecting

After the first sync, Stateful extracts structured facts — relationships, preferences, projects — and stores them in your knowledge graph. They show up in your wiki and are available to any AI you connect.

Cloud connectors stay live and sync incrementally as new data arrives.

Privacy

  • Disconnect any source at any time; that stops future syncs.
  • You choose what goes in — connect only the sources you want Stateful to see.
  • Your data is never used to train models or shared with third parties.

On this page

Connect Sources