Skip to main content

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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

lifenote-0.1.1.tar.gz (13.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

lifenote-0.1.1-py3-none-any.whl (14.9 kB view details)

Uploaded Python 3

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

Hashes for lifenote-0.1.1.tar.gz
Algorithm Hash digest
SHA256 11273f0c2d7e6030cb165f00b72d66b81f3cc5515fb5cff3ded97cd74d8f548d
MD5 0c8accdac2b93e88785d3ef764a17673
BLAKE2b-256 9bb719d043104e830a96fef48b370cead785fffa05d028150413bffaf5e13897

See more details on using hashes here.

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

Hashes for lifenote-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 1f6bdace2f9207add3574baf2993c59163bceed3c3679d571a0193ada05e7463
MD5 91e1f134831e3011b5b14bf3fded29b8
BLAKE2b-256 b82d8051c26617de4d4af2b4005f77c7342ba1038a03a0cd524093d76d53e318

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page