Docs menu

Bring your AI assistant to your dream journal

UnderSelf runs a remote MCP server at https://api.underself.io/mcp. Connect it once to Claude, Grok, ChatGPT, Gemini or Meta Muse, and you can tell your assistant last night's dream, ask what you dreamed last week, or search your dream journal, right in the chat.

Updated September 24, 2026

Tell your assistant a dream the moment you wake, and it lands in your journal with a reading. Ask what you dreamed last week, or what keeps coming back, and it answers from your own entries. You approve the connection once, and you can switch it off any time.

An open handwritten notebook with a pen, a mug and a phone lying dark on a wooden bedside table at night, city lights blurred in the window.

The 60-second version

  • Open your AI app's connector settings and choose to add a custom connector (each app names it a little differently; see the guides below).
  • Paste the UnderSelf server URL.
  • Sign in to UnderSelf with Google or Apple, read what the app will be able to do, and tap Approve.
  • Back in your AI app, ask it about your dreams.
MCP server URL
https://api.underself.io/mcp

Step by step guides: connect Claude (the flow we test ourselves), Grok, including in a Tesla, ChatGPT, Gemini and Meta Muse. Building your own client? Read the technical flow.

How does a connection work?

Your AI app asks UnderSelf for access. UnderSelf shows you a consent page in your browser. You approve, and the app gets a key that opens only your dream journal, nothing else in your account.

What can you ask?

Once connected, your assistant has six tools. You never need to name them; just talk the way you normally would.

  • Save a dream. "Log this dream: I was in my old school and the stairs kept going up." Your assistant uses record_dream, and by default you get a reading back.
  • Get a fresh reading. "Give me another reading of that dream." This is analyze_dream.
  • Open one dream. "Show me the dream about the lighthouse and its reading." This is get_dream.
  • Look back. "What did I dream this week?" This is list_dreams.
  • Search. "Have I dreamed about water before?" This is search_dreams.
  • See the bigger picture. "What patterns do you see in my dreams?" This is get_patterns, with your recent chapter, how often you record, and your Inner Map.

See everything you can ask for, with each tool's inputs and a sample of what comes back. A reading is a reflection to think with, not advice.

Security and privacy

  • You approve it once. The consent page shows the app's name, where it sends you back to, and exactly what it will be able to do. Nothing connects until you tap Approve.
  • It reaches your dream journal and nothing else. A connection can read your dreams, readings and patterns, and record new dreams and readings. It cannot delete a dream, see your payment details or change your account.
  • Your plan still applies. New dreams and readings count against the same limits as the app. When you reach one, your assistant reads you a short message with a link to your options.
  • You can switch it off any time. Go to app.underself.io/account, open Connected apps and tap Disconnect. Its access stops within 15 minutes. Removing the connector in your AI app also stops it, but only the Disconnect button is guaranteed to end access on our side.
  • Unused connections lapse. A connection you have not used for 30 days ends by itself, and every connection ends after 90 days at most. Reconnecting takes a minute.
  • Your dreams go to the AI app you chose. When your assistant reads or records a dream, that text passes through the AI app, and that app's own privacy terms cover what it keeps. Choose an assistant you already trust with personal writing.

About the Known app mark.Some apps show a Known app mark on the consent page. It means the link returns to that app's own web address. It does not mean UnderSelf vouches for the app. Only approve a connection you started yourself.

Which AI apps work with your dream journal?

Verified means we have connected that app ourselves and used it to save and read dreams. Standard MCP means the app supports the same open standard, so it should connect the same way, but we have not tested it end to end yet. Using something else? See any other MCP client.

Suggested prompts

Questions

Is it free to connect?

On the UnderSelf side, yes: connecting costs nothing on any plan, and what you do through it uses your plan the same way the app does. Some AI apps only offer connectors on their own paid plans; each guide says what we know.

Which UnderSelf plan do I need?

Any plan, including Free. New dreams and readings count against your plan's limits, so a Free account can connect and will meet the same limits it meets in the app. See plans if you want more room.

Does it work on my phone?

Setup is easiest on a computer, because your AI app opens the UnderSelf consent page in a browser. Once connected, many assistants carry the connection into their phone apps, so you can talk to your journal there too. Each guide notes what its app supports.

Can the AI delete my dreams?

No. A connection can read your journal and add new dreams and readings. It cannot delete or edit a dream, and it cannot reach anything else in your account.

What does the AI app see?

Only what a tool returns: the dreams, readings and patterns it asks for while helping you. Those pass through the AI app, and its own privacy terms cover what it keeps. It never sees your sign in details, payment details or the rest of your account.

How do I disconnect?

Open app.underself.io/account, go to Connected apps and tap Disconnect. Its access ends within 15 minutes. Removing the connector inside your AI app works too, but Disconnect is the sure way.

Why does my assistant say I reached a limit?

Your plan has a limit on new dreams or readings, and the connection uses the same limits as the app. Your assistant reads you the exact message, with a link to plans. If the dream limit is the one reached, the dream is not saved; if it is the reading limit, the dream is saved without a reading.

Is my AI app supported?

Claude is verified. Grok, ChatGPT, Gemini and Meta Muse use the same open standard and should work, but we have not tested them ourselves yet. Most MCP clients that support OAuth sign in should connect; if yours does not, write to info@underself.io.