Introducing the Reflection MCP: Connect Your Journal to Claude, ChatGPT, and More
July 28, 2026
Product Updates
Contents
We just released the Reflection MCP in Beta for Premium members. It connects your private journal to the AI assistants you already use, so you can explore years of your own writing from inside Claude, ChatGPT, Cursor, or any other app that supports the Model Context Protocol.
Setup is one key and one link. There's nothing to install.
What you can do with it
- Ask questions across years of your writing. "What was I wrestling with last winter?"
- Look something up mid-conversation. You're talking something through, it turns personal, and you ask your assistant to check what you wrote the last time this came up.
- Save reflections from a chat. Tell it to add a realization to your journal and it goes in as a normal entry.
The part we think is most interesting is what happens when your journal sits next to your other tools.
- Pull other data in. If health, fitness, or calendar data already reaches your AI through another connector, you can have it written into your journal as an entry, with a prompt waiting for you to reflect on it.
- Build the review we don't offer. We generate Weekly, Monthly, and Annual Reviews in the app, but we can't anticipate every question you'd want to ask of your own life. If your AI supports scheduled tasks, as Claude does, you can build your own: a Sunday summary of every entry mentioning a specific person, a monthly readout on one goal, a quarterly look at how your thinking has shifted. Describe it once and it runs on its own.
Our guide to AI journaling with MCP goes deeper on all of these, with example prompts to try.
How to set it up
- Open Settings → MCP Key Management in Reflection. This is where you create, view, and revoke connector keys.
- Tap Generate MCP Key and name it something you'll recognize later, like "Claude Desktop."
- Copy the connection URL from the dialog that appears:
https://mcp.reflection.app/mcp?token=<your-key>. - Add it to your AI client. In Claude, ChatGPT, Cursor, or your client of choice, add a new custom remote MCP server or connector and paste the URL in.
That's it. Ask your assistant a question about your journal to confirm it's working.
Two things to know. Your key is shown only once, so store it somewhere safe, and treat it like a password since it can reach and add to your journal. If it's ever compromised, revoke it from the same screen and generate a new one. Some clients also load tools lazily, so if yours can't see Reflection right away, ask it to list its available tools.
Advanced clients that prefer an Authorization: Bearer header instead of a URL token can find the raw key under Advanced in the same dialog.
What it can and can't do
Your assistant gets nine tools. Six for exploring your journal:
get_dashboardfor an overview of your journallist_entriesto page through your historycount_entriesto size up a date range before readingget_entryto open a single entryget_profilefor basic account infolist_templatesfor your quick templates
And three for adding to it:
create_entryto add a new entryupdateentrytagsto change the tags on an entrycreate_templateto save a new template
There's no delete tool, no bulk edit, and no way to rewrite an entry that already exists. Entries are write-once, and the only thing the connector can change about an existing entry is its tags. Anything added through it is automatically tagged "MCP", so you can always tell how an entry got into your journal.
By default your assistant sees only short, redacted previews of your entries and opens a full entry only when your question calls for it. Every key keeps an activity log you can check, and revoking a key blocks the very next request.
Notes on the Beta
This is our first release, so we recommend keeping a recent backup of your journal. MCP support also varies between AI clients, and several are still changing quickly.
We'd love to hear what you build with it, especially the routines. If something doesn't work the way you expect, or you want a tool we haven't shipped, tell us.
We just released the Reflection MCP in Beta for Premium members. It connects your private journal to the AI assistants you already use, so you can explore years of your own writing from inside Claude, ChatGPT, Cursor, or any other app that supports the Model Context Protocol.
Setup is one key and one link. There's nothing to install.
What you can do with it
- Ask questions across years of your writing. "What was I wrestling with last winter?"
- Look something up mid-conversation. You're talking something through, it turns personal, and you ask your assistant to check what you wrote the last time this came up.
- Save reflections from a chat. Tell it to add a realization to your journal and it goes in as a normal entry.
The part we think is most interesting is what happens when your journal sits next to your other tools.
- Pull other data in. If health, fitness, or calendar data already reaches your AI through another connector, you can have it written into your journal as an entry, with a prompt waiting for you to reflect on it.
- Build the review we don't offer. We generate Weekly, Monthly, and Annual Reviews in the app, but we can't anticipate every question you'd want to ask of your own life. If your AI supports scheduled tasks, as Claude does, you can build your own: a Sunday summary of every entry mentioning a specific person, a monthly readout on one goal, a quarterly look at how your thinking has shifted. Describe it once and it runs on its own.
Our guide to AI journaling with MCP goes deeper on all of these, with example prompts to try.
How to set it up
- Open Settings → MCP Key Management in Reflection. This is where you create, view, and revoke connector keys.
- Tap Generate MCP Key and name it something you'll recognize later, like "Claude Desktop."
- Copy the connection URL from the dialog that appears:
https://mcp.reflection.app/mcp?token=<your-key>. - Add it to your AI client. In Claude, ChatGPT, Cursor, or your client of choice, add a new custom remote MCP server or connector and paste the URL in.
That's it. Ask your assistant a question about your journal to confirm it's working.
Two things to know. Your key is shown only once, so store it somewhere safe, and treat it like a password since it can reach and add to your journal. If it's ever compromised, revoke it from the same screen and generate a new one. Some clients also load tools lazily, so if yours can't see Reflection right away, ask it to list its available tools.
Advanced clients that prefer an Authorization: Bearer header instead of a URL token can find the raw key under Advanced in the same dialog.
What it can and can't do
Your assistant gets nine tools. Six for exploring your journal:
get_dashboardfor an overview of your journallist_entriesto page through your historycount_entriesto size up a date range before readingget_entryto open a single entryget_profilefor basic account infolist_templatesfor your quick templates
And three for adding to it:
create_entryto add a new entryupdateentrytagsto change the tags on an entrycreate_templateto save a new template
There's no delete tool, no bulk edit, and no way to rewrite an entry that already exists. Entries are write-once, and the only thing the connector can change about an existing entry is its tags. Anything added through it is automatically tagged "MCP", so you can always tell how an entry got into your journal.
By default your assistant sees only short, redacted previews of your entries and opens a full entry only when your question calls for it. Every key keeps an activity log you can check, and revoking a key blocks the very next request.
Notes on the Beta
This is our first release, so we recommend keeping a recent backup of your journal. MCP support also varies between AI clients, and several are still changing quickly.
We'd love to hear what you build with it, especially the routines. If something doesn't work the way you expect, or you want a tool we haven't shipped, tell us.
Gain clarity and peace of mind, wherever you are.
Download Reflection to start journaling today.
Scan with phone.
