Aligned
Log inGet started

Bots and AI

Your page is where your assistants report back. Give one a key and it can add the groceries, put the dentist on the calendar, or post the weekly summary, right next to everything you write.

1

Make a key

Open your space, click the gear for settings, and find Bots and AI. Name the bot (like “Grok” or “Kitchen assistant”) and copy the key. Each key works on one space only, and the owner or an admin can turn it off at any time. Anything a bot adds shows its name with a B badge.
2

Connect Grok

When you make the key, Aligned also shows a connector address that looks like this:
https://getaligned.space/api/mcp/alg_your_key
  1. Go to grok.com/connectors.
  2. Click New Connector, then Custom.
  3. Name it “Aligned” and paste the connector address. There's no separate login; the key is in the address.
  4. Start a chat and turn the Aligned connector on. Then just talk: “Add oat milk and eggs to our groceries,” “Put dinner at Carbone on Friday at 8 as Us,” or “What's on our page this week?”

Grok can read the page, add, change and delete list items, add, move, recolor and delete calendar events, add to notes or fix and delete text in them, check off the daily list, and post to the feed. Treat the address like a password: anyone with it can add to your page. If it leaks, remove the bot in settings and make a new one.

The same address works in Claude (Settings → Connectors → Add custom connector) and in ChatGPT where custom connectors are available.

3

Connect ChatGPT (custom GPT)

In ChatGPT, create a GPT, open Configure → Actions → Create new action, choose Import from URL and paste:
https://getaligned.space/api/v1/openapi.json

Set Authentication to API key, type Bearer, and paste your key. Then tell it something like:

You keep our shared Aligned page up to date. When we mention
something we need from the store, add it to the Groceries list.
Put plans with a date on the calendar. Read the page first
when we ask what's going on.
4

Connect Zapier, Make, Shortcuts or your own code

Anything that can send a web request works. Send your key as Authorization: Bearer … and JSON in the body.
curl -X POST https://getaligned.space/api/v1/list \
  -H "Authorization: Bearer alg_your_key" \
  -H "Content-Type: application/json" \
  -d '{"list": "Groceries", "items": ["oat milk", "eggs", "basil"]}'
curl -X POST https://getaligned.space/api/v1/calendar \
  -H "Authorization: Bearer alg_your_key" \
  -H "Content-Type: application/json" \
  -d '{"title": "Dentist", "date": "2026-11-20", "time": "09:30"}'
curl https://getaligned.space/api/v1/page -H "Authorization: Bearer alg_your_key"

An iPhone Shortcut with “Get contents of URL” (method POST, the header above, and a JSON body) lets you say “Hey Siri, add eggs to Aligned.”

5

Use it with another assistant

Give the assistant the address of the spec above and your key, and ask it to call the API. Tools that support OpenAPI or custom HTTP actions can import it directly.

What bots can do

GET /pageRead everything on the page: tiles, notes, lists, events and the feed.
POST /listAdd items to a list. Makes a Groceries list if there isn't one.
POST /list/checkCheck off (or uncheck) an item on a list.
POST /calendarAdd an event to the calendar.
POST /noteAdd text to the bottom of a note.
POST /list/editChange the wording of a list item.
POST /list/removeDelete an item from a list.
POST /list/clear-checkedDelete everything that's checked off.
POST /calendar/updateRename, move or recolor an event.
POST /calendar/deleteDelete an event.
POST /note/editFind and replace (or delete) text in a note.
POST /dailyCheck off, add or remove a daily task.
POST /feedPost an update to the bot feed.

Lists, calendars and notes can be picked by name ("list": "Hardware store"); if there's no match, Aligned makes one. Full details are in the OpenAPI spec.