Connect Claude to UnderSelf

It takes about a minute. You need an UnderSelf account (any plan) and a Claude account. Want the bigger picture first? See every supported app.

Before you start#

• Anthropic offers custom connectors on Claude's Free, Pro, Max, Team and Enterprise plans. On Free you can add one custom connector.
• On a Team or Enterprise plan, an owner adds the connector for the organization first, then each person connects it for themselves.
• Set it up on claude.ai or in Claude Desktop. Anthropic says connectors work in Claude's iOS and Android apps, but adding a custom connector there is still in beta, so the web or desktop is the easier place to start.

Connect Claude in six steps#

1. 1

   Open your connectors

   On claude.ai or in Claude Desktop, open Customize, then Connectors. Some versions keep it under Settings, Connectors. On a Team or Enterprise plan, an owner adds the connector first under Organization settings, Connectors.

2. 2

   Add a custom connector

   Choose +, then Add custom connector. Name it UnderSelf and paste the server URL: https://api.underself.io/mcp. Leave the advanced OAuth fields empty; Claude registers itself.

3. 3

   Connect

   Save it, then choose Connect. Claude opens the UnderSelf consent page at app.underself.io in your browser.

4. 4

   Sign in to UnderSelf

   Sign in with Google or Apple, the same way you sign in to the app. Use the account that holds your dream journal.

5. 5

   Check and approve

   The page shows the app's name, Sends you back to claude.ai, and what it will be able to do: read your dreams, readings and patterns, and record new dreams and request readings. Tap Approve.

6. 6

   Say hello to your journal

   Back in Claude, UnderSelf shows six tools. In a chat, make sure it is switched on under the + button, Connectors, then try: "Log this dream: I was in a house with extra rooms."

Check it worked#

Ask Claude to log a short dream. When we tried "Log this dream: ...", Claude called record_dream and came back in about ten seconds with the dream saved and its reading. Open the UnderSelf app and you will find the same dream in your journal.

Now see what you can ask Claude: six tools for saving, reading, searching and spotting patterns.

Suggested prompts#

Troubleshooting#

Claude says it has no UnderSelf tools#

Check that the connector is switched on for this chat (the + button, Connectors). If it says it needs to connect, open it in Customize, Connectors and select Connect again.

"The connection to UnderSelf has expired"#

A connection lapses after 30 days without use, and after 90 days at most. Disconnect and connect again in Claude's connector settings; it takes a minute.

"This account has reached its dream limit"#

Your plan's limit applies here the same way it does in the app. The message links to plans. Your earlier dreams stay readable.

The reading is taking a while#

A reading can take up to about two minutes. If it runs long, your dream is still saved; ask Claude to open it again in a minute. If it still has no reading, ask for a new one.

Still stuck? Read the full OAuth and error reference or write to info@underself.io.

Disconnect#

Open app.underself.io/account, go to Connected apps and tap Disconnect next to Claude. Claude's access stops within 15 minutes, and your dreams stay in your journal. Removing the connector in Claude's settings works too, but Disconnect is the sure way.