Journalowl

MCP (Model Context Protocol) server for JournalOwl - AI-powered journaling integration for Claude Code, Cursor, and ChatGPT Agents.

Features

• Create journal entries directly from your AI assistant
• Search and browse your journal entries
• Access weekly reviews with emotional trends and insights
• Get personalized suggestions based on your writing style
• Secure API key authentication with scoped permissions

Installation

npx @mindfulabai/journalowl-mcp

Or install globally:

npm install -g @mindfulabai/journalowl-mcp

Configuration

1. Get your API Key

1. Log in to JournalOwl
2. Go to Settings > API Keys
3. Create a new API key with the scopes you need:
   • journal:read - Read your journal entries
   • journal:write - Create new entries
   • review:read - Access weekly reviews
   • profile:read - Access your profile and writing style

2. Configure Claude Code

Add to your ~/.claude.json:

{
  "mcpServers": {
    "journalowl": {
      "command": "npx",
      "args": ["@mindfulabai/journalowl-mcp"],
      "env": {
        "JOURNALOWL_API_KEY": "jowl_sk_your_api_key_here"
      }
    }
  }
}

3. Configure Cursor

Add to your Cursor MCP settings:

{
  "journalowl": {
    "command": "npx",
    "args": ["@mindfulabai/journalowl-mcp"],
    "env": {
      "JOURNALOWL_API_KEY": "jowl_sk_your_api_key_here"
    }
  }
}

Available Tools

Tool	Description
journal_create_entry	Create a new journal entry
journal_list_entries	List entries with filters
journal_get_entry	Get entry details and analysis
journal_search	Search entries by text
journal_get_weekly_review	Get weekly review and insights
journal_get_writing_style	Get writing style preferences

Available Resources

URI	Description
journalowl://user/profile	User profile and journaling stats
journalowl://user/recent-entries	Recent entries metadata

Example Usage

Once configured, you can use JournalOwl directly in your AI conversations:

"Create a journal entry about my productive day at work"

"Show me my journal entries from last week"

"What insights does my weekly review show?"

"Search my journal for entries about anxiety"

Development

# Clone the repository
git clone https://github.com/mindfulabai/journalowl-mcp.git
cd journalowl-mcp

# Install dependencies
npm install

# Build
npm run build

# Run in development mode
npm run dev

# Test with MCP Inspector
npm run inspector

Security

• API keys are transmitted securely via HTTPS
• Keys are hashed in our database (we never store the plain key)
• You can revoke keys at any time from JournalOwl settings
• Scopes limit what each key can access

Support

• Documentation
• GitHub Issues
• JournalOwl Support

License

MIT