Integration
MCP Integration
Connect Clarity to Claude Desktop, Cursor, or any MCP-compatible client. Manage your intentions through natural conversation.
Setup
Open your MCP client config
For Claude Desktop, open Settings → Developer → Edit Config.
For Cursor, go to Settings → MCP Servers → Add Server.
Add the Clarity MCP server
Add this to your configuration:
For Claude Code, add to ~/.claude.json:
{
"mcpServers": {
"clarity": {
"type": "http",
"url": "https://daywithclarity.com/api/mcp"
}
}
}For Claude Desktop, add to your config:
{
"mcpServers": {
"clarity": {
"url": "https://daywithclarity.com/api/mcp"
}
}
}Authenticate
When your MCP client connects for the first time, it will open your browser and ask you to sign in with Google. This is a one-time setup — your client will automatically refresh the token after that.
Start using it
That's it. You can now ask your AI assistant to manage your intentions. Try something like "What's in my focus today?"
Available Tools
8 tools are available, each with multiple actions. Your AI assistant picks the right one automatically.
query_intentions
Search and list your intentions
manage_intention
Create, update, and delete intentions
manage_focus
Control your focus list (max 20 items)
manage_schedule
Schedule intentions and view upcoming
manage_collection
Organize intentions into collections
manage_children
Manage sub-intentions
manage_tracker
Track habits and counters
start_focus_session
Start a pomodoro or custom focus timer
Example Prompts
Just talk naturally. The AI figures out which tool and action to use.
What's in my focus today?
→ query_intentions → list_focus_today
Create an intention called 'Write blog post'
→ manage_intention → create
Mark 'Write blog post' as done
→ manage_intention → update_status
Add 'Exercise' to my focus
→ manage_focus → add
Schedule 'Team meeting' for tomorrow at 3pm
→ manage_schedule → set_date
Show my collections
→ manage_collection → list
What's coming up this week?
→ manage_schedule → list_upcoming
I did my workout today
→ manage_tracker → toggle_tracker
Start a 25-minute pomodoro
→ start_focus_session → start
Find my meditation intention
→ query_intentions → search_by_title
What is MCP?
MCP (Model Context Protocol) is an open standard that lets AI assistants connect to external tools and services. When you connect Clarity via MCP, your AI assistant can read and manage your intentions directly — no copy-pasting or switching between apps.
Your data stays secure. The connection uses OAuth authentication (the same kind of "Sign in with Google" flow you already use), and your AI assistant can only access your own intentions.