# Integrations and live cards

Bring calendars, to-dos, weather, news, your accounts and your own APIs onto your boards.

Canonical: https://help.lair.so/guides/integrations

## Connect a built-in integration

Open **Library → Integrations** and pick a tile under **Ready to connect**. Each one fills a card.

- **Google Calendar:** connect Google when available. Lair reads events into Up next; this integration is read-only.
- **Any calendar (iCal link):** paste an iCal or webcal feed from your calendar provider. Treat private feed links as secrets.
- **Todoist:** add your API token. Your to-dos appear on the Today card, and permitted agents can add or complete them.
- **Weather:** choose a place. No weather account is needed.
- **News feeds:** choose topics and RSS feeds for Headlines.
- **Home Assistant, SwitchBot, Philips Hue:** add the token (or your own Hue app) and your lights, plugs, blinds, locks and sensors appear on the Home card.
- **Spotify:** add your own Spotify app and sign in to see what’s playing and move music between speakers. Playing music needs Spotify Premium.

## Connect an account with a key

Under **Connect with a key** on the same tab: GitHub (your reviews, pull requests and assigned issues), Stripe (balance and payments), Vercel (deployments), YNAB (this month’s budget), Last.fm (what you’ve played), Raindrop.io (saved links), Trello (your cards), Splitwise (balances), Healthchecks.io (your checks) and Plausible (visitors). Paste a key you make in that app and choose the board its cards go on. See [the Library](https://help.lair.so/guides/library#connect-with-a-key).

## Your smart home and music

Connect **Home Assistant**, **SwitchBot**, **Philips Hue** or **Spotify** in Library → Integrations and Lair adds a **Home** card: one tile per light, plug, blind, lock, speaker and sensor, plus your scenes and what’s playing.

Agents can only see or control your home if you give them the home permission in **Settings → Agents**. Even then, an agent can never unlock a door, open a garage door or gate, or run a scene whose name sounds like it does. Only you can, from your Lair.

Keys and tokens are locked in your Lair, only ever sent to that one service, and never shown again or given to an agent.

## Bring an app through your agents

Some apps come through an agent that already has access to them. For example, an agent with Gmail, Outlook or Slack access can post useful items to Inbox highlights. Picking an app during setup does not grant Lair or an agent access to that service.

Connect the service in your AI app, then ask your agent to bring the relevant information into your Lair. Review that agent’s permissions in Settings → Agents.

## Make a live card from an API

1. On a board, choose **Add card → Live card from any web API**, or ask an agent to make one.
2. Choose the API address and the information the card should show.
3. If the service needs a key, add it right there, or in **Library → Integrations → Your own, from any web API** for the API’s host.

Keys stay in your Lair and are not shown to agents. A key only goes to the host it belongs to. Review requests that need extra access before allowing them.

If a card says **Not updating**, read its message on the card or in Library → Integrations, check the connection or key, and retry. Cards keep their last good data while a service is unavailable.