Bring your private journal into your AI agents — Claude Code, Cursor, Codex. MCP-compatible.
Project description
lifenote
Bring your private Life Note journal into your AI agents — Claude Code, Claude Desktop, Cursor, Codex, anything that speaks MCP.
Install
pipx install lifenote # recommended
# or
pip install lifenote
Sign in
lifenote auth login
Opens your browser, you click Allow, you're done. Your token is stored in your OS keychain (macOS Keychain / Windows Credential Manager / Linux libsecret) — never in plain files.
For CI / Docker / headless agents, set LIFENOTE_API_TOKEN in the environment instead.
Use it from the terminal
lifenote search "anxiety about launch"
lifenote entries --since 7d
lifenote today
lifenote week
lifenote conversations list
lifenote conversations show 574
Add --json to any command for piping into agents:
lifenote search "burnout" --json | claude "summarize the patterns"
Use it from your AI agent (MCP)
Claude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"lifenote": {
"command": "lifenote",
"args": ["mcp"]
}
}
}
Restart Claude Desktop. Your journal is now a tool Claude can reach for on its own.
Claude.ai web (Connectors)
Settings → Connectors → Add → paste https://mcp.mylifenote.ai/api/agent/v1/mcp. Approve the OAuth screen.
Cursor / Codex / other MCP clients
Same command: lifenote, args: [mcp] pattern. Or point them at the HTTP endpoint directly.
Bundled Claude Code skill
Drop a brand-aligned skill into your ~/.claude/skills/ so Claude Code knows when to reach for Life Note vs. when not to:
lifenote skills install
What the agent can read
Two scopes today, both read-only:
journal:read— your written entries + AI-generated analysis (themes, feelings)chat:read— your past conversations with mentors (Marcus Aurelius, etc.)
It cannot write to your journal, change your settings, see payment info, or access other users' data.
You can revoke any agent anytime at https://www.mylifenote.ai/settings/agents.
Configuration
Environment variables (all optional):
LIFENOTE_API_TOKEN— bypass keychain (essential for CI / Docker)LIFENOTE_BASE_URL— point at staging / dev (default:https://www.mylifenote.ai)
License
MIT. Built by Daniel W. Chen.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file lifenote-0.1.1.tar.gz.
File metadata
- Download URL: lifenote-0.1.1.tar.gz
- Upload date:
- Size: 13.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.1
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
11273f0c2d7e6030cb165f00b72d66b81f3cc5515fb5cff3ded97cd74d8f548d
|
|
| MD5 |
0c8accdac2b93e88785d3ef764a17673
|
|
| BLAKE2b-256 |
9bb719d043104e830a96fef48b370cead785fffa05d028150413bffaf5e13897
|
File details
Details for the file lifenote-0.1.1-py3-none-any.whl.
File metadata
- Download URL: lifenote-0.1.1-py3-none-any.whl
- Upload date:
- Size: 14.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.1
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
1f6bdace2f9207add3574baf2993c59163bceed3c3679d571a0193ada05e7463
|
|
| MD5 |
91e1f134831e3011b5b14bf3fded29b8
|
|
| BLAKE2b-256 |
b82d8051c26617de4d4af2b4005f77c7342ba1038a03a0cd524093d76d53e318
|