Before you start
You need:
- A List account (free)
- A Claude account — Free, Pro, Max, Team, or Enterprise all work
Step 1 — Open Connectors in Claude
Go to claude.ai and click Customize in the left sidebar, then select Connectors.
Or click the + button in the bottom-left of any conversation and choose Connectors.
Step 2 — Add List as a custom connector
- Click Add custom connector.
- Paste this URL into the server field:
https://list.unlokd.com/api/mcp
- Click Add.
That’s it. Claude detects the server and its tools automatically.
Step 3 — Authorize on first use
The first time you ask Claude to use List in a conversation, it will prompt you to sign in. Complete the OAuth flow and you’re connected — it won’t ask again.
Step 4 — Test it
Give me a weekly review checklist with timed steps and save it to List.
Open your lists — it should appear there immediately.
Mobile and desktop
Once you add the connector in Claude.ai web, it syncs automatically to the Claude mobile app and Claude Desktop. No extra setup needed on those devices.
Using Claude Desktop config instead
If you prefer to configure Claude Desktop directly via the config file, open it at:
~/Library/Application Support/Claude/claude_desktop_config.json
And add:
{
"mcpServers": {
"list": {
"type": "http",
"url": "https://list.unlokd.com/api/mcp"
}
}
}Restart Claude Desktop and authorize when prompted.
Troubleshooting
- I don’t see Connectors in the sidebar
- Make sure you’re on claude.ai and signed in. The Connectors option appears in the Customize panel in the left sidebar.
- Authorization fails or loops
- Try signing out of List and back in, then remove and re-add the connector in Claude.
- Lists aren’t appearing
- Refresh your lists page. If the problem persists, contact us.