# Connect an AI assistant

You can connect Claude or ChatGPT to your Songstead library. A connected assistant can find songs, fill in song details, tag songs and build sets for you, working in your library the way you would.

> [!PLAN] Backstage
> Connecting an AI assistant needs Backstage or Harmony.

## Connect ChatGPT

Songstead is in ChatGPT's plugin library.

1. In ChatGPT, select **Plugins** in the menu on the left, and search for **Songstead**.
2. Select **Songstead**, then **Install plugin**.
3. ChatGPT sends you to Songstead. Sign in, choose what ChatGPT can do, and select **Allow**. See [Approve the connection](https://songstead.app/docs/ai-agents.md#approve-the-connection).

![ChatGPT's Plugins page. "songstead" is typed into the search box, Songstead appears with its tagline "Settle in. Play on.", and selecting it opens its page, with an Install plugin button at the top right.](https://songstead.app/docs/ai-agents/chatgpt-find.webp "desktop")

## Connect Claude

Songstead is coming to Claude's connector directory. Once it's there, you'll find it by searching for **Songstead** in Claude's connectors. Until then, add it as a custom connector, as described in the next section.

## Connect another assistant

If your assistant doesn't list Songstead, or you'd rather set it up yourself, add a custom connector with this URL:

```
https://my.songstead.app/mcp
```

This works in Claude and in any other assistant that supports custom connectors.

## Approve the connection

However you connect, the assistant sends you to Songstead to sign in and approve the connection. You choose what it can do:

| Access | What the assistant can do |
| --- | --- |
| Read only | See your songs, charts, sets, tags, groups and files. |
| Read and edit | All of that, and create and change songs, charts, sets, tags and files. |

Select **Allow** to connect.

## What an assistant can't do

A connected assistant can't delete songs, sets, charts, tags or files. It can take a tag off a song and a song out of a set, but nothing more destructive. It also has no access to your plan, billing, account settings, annotations, or your groups' members and invites.

Everything an assistant changes goes through the same permissions you have. It can't edit a song in a group where you're a viewer.

## Things to ask

- "Tag every song over 120 bpm as upbeat."
- "Make a 45-minute set from my songs tagged acoustic."
- "Which songs in my library are in the key of D?"
- "Fill in the tempo and time signature for the songs that are missing them."

> [!NOTE]
> Most assistants won't write out a song's lyrics, because they're copyrighted, so an assistant isn't a good way to add new songs. Add those yourself, by typing, pasting or [importing](https://songstead.app/docs/import.md) them. Assistants work fine with the songs already in your library.

## Manage connections

**Connected Apps** in **Account** lists every connection, whether it can edit, and when it was last used. **Disconnect** ends a connection straight away. See [Account](https://songstead.app/docs/account.md).

## Ask an assistant about Songstead

These docs are published for assistants too. Point any AI assistant at [songstead.app/llms-full.txt](https://songstead.app/llms-full.txt) and it can answer questions about how Songstead works, whether or not it's connected to your library. Each page is also available as Markdown by adding `.md` to its address.