observations
Short, discrete noticings — one or two sentences each
How to use it
observations is exposed by the Private Journal MCP MCP server. Add the server to your MCP client (Claude Desktop, Cursor, Windsurf and others), and the observations tool becomes available to the model automatically. See the full listing for setup details and every tool this server provides.
Install Private Journal MCP
npx github:obra/private-journal-mcp --journal-path /path/to/journalsOther tools in Private Journal MCP (15)
Days back to search (default: 30)
Maximum results (default: 10)
Browse recent entries chronologically:
(required): File path from search results
Multi-section private journaling with these optional categories:
Technical insights specific to current project
(required): Natural language search query
Read full content of specific entries:
Integrated thinking — what you noticed, felt, understood, or processed
Semantic search across all journal entries:
Filter by specific categories
General software engineering learnings
Search scope - 'project', 'user', or 'both' (default: 'both')
Notes about collaborating with humans
Domain knowledge and interesting discoveries