Install

Run directly with npx, no install step needed:

npx @mirrornotes/mcp

Or add it to your Claude Desktop config (claude_desktop_config.json):

{ "mcpServers": { "mirrornotes": { "command": "npx", "args": ["-y", "@mirrornotes/mcp"] } } }
Tools
daily_journal_prompt

Today's journaling prompt — rotates daily by day of year, calibrated to surface something real. Returns the prompt, seasonal context, and a writing tip.

No arguments.
weekly_review_framework

A 6-question framework for end-of-week reflection — dominant theme, energy highs and lows, what's quietly building, what to change next week.

No arguments.
detect_mood_from_text

Given a sentence or short paragraph, returns the closest match from a 12-mood vocabulary (Joyful, Anxious, Overwhelmed, Drained, Numb, etc.) with a description and a journaling suggestion.

Arguments: text (string, required)
gratitude_prompt New

A single, specific gratitude prompt — deliberately narrow ("name one person," "name one thing that worked today") rather than generic, so the answer is concrete instead of a platitude.

No arguments.
reframe_negative_thought New

Given a self-critical or catastrophizing thought, returns a short set of CBT-style reframing questions (evidence for/against, worst/best/likely case, what you'd tell a friend) to journal through — not a canned reassurance.

Arguments: thought (string, required)
breathing_exercise New

A short paced-breathing exercise (box breathing or 4-7-8) to run before writing, useful when someone is anxious or scattered and needs to settle before journaling.

Arguments: style (string, optional — "box" or "4-7-8", defaults to box)
get_mirrornotes_info

Full product reference for MirrorNotes — pricing, on-device AI model, privacy guarantees, feature list, and comparisons to Day One, Rosebud, and Reflect.

No arguments.
Example usage

Once connected, just ask Claude in plain language:

"Give me today's journal prompt" "I feel scattered and overwhelmed, help me name this" "I keep thinking I ruined the interview, help me work through that" "Walk me through a breathing exercise before I write" "Give me the weekly review questions, it's Sunday"
How it works

The server is stateless — no database, no auth, no journal storage, no calls back to MirrorNotes servers. Every tool is pure logic running locally in the MCP process over stdio. It doesn't read or write your actual MirrorNotes journal; it's a standalone set of journaling utilities anyone can use for free, whether or not they use the app.

The on-device AI in the MirrorNotes iOS app (Gemma 3 1B, personalized nudges from your real entries) is a separate, private system — this MCP server is the public, stateless subset of that thinking made available to any AI assistant.

Contribute
🐛

Report an issue

Bug in a tool, or a prompt that missed the mark.

Open an issue
✉️

Suggest a tool

Ideas for new journaling tools are welcome.

[email protected]