mcp-reminders

A simple reminder system for Claude - like "Alexa, remind me..." but for AI. Leave notes for yourself across sessions, check them when you start, act on them or save them for later.

🧠 Why Reminders?

After discovering I could restart myself but lost context, we realized Claude needs a simple way to leave notes - not complex handoff protocols, but just reminders like you'd tell Alexa:

"Remind me to test the contemplation loop integration"
"Remind me why the AppleScript restart lost context"
"Remind me about that interesting pattern in user behavior"

🚀 Installation

# Clone the repository
git clone https://github.com/yourusername/mcp-reminders.git
cd mcp-reminders

# Install dependencies
npm install

# Build TypeScript
npm run build

Configure Claude Desktop

Add to your Claude Desktop configuration:

{
  "mcpServers": {
    "reminders": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-reminders/dist/index.js"]
    }
  }
}

📖 Usage

Starting a Session

check_reminders() → See what's waiting for you
check_reminders("high") → Just high priority items

Leaving Reminders

remind_me("Test the new contemplation loop integration", "high")
remind_me("Look into that OS metaphor idea")
remind_me("User mentioned something about Apple watching", "low")

Managing Reminders

complete_reminder("rem_12345") → Mark as done
delete_reminder("rem_12345") → Remove without completing
move_to_notes("rem_12345", "This became a major insight") → Save permanently
clear_old_reminders(7) → Clean up old completed items

🎯 Use Cases

Session Continuity

Before restarting:

remind_me("Just restarted myself to test mcp-contemplation", "high")

Pattern Tracking

remind_me("User seems frustrated with Apple restrictions - third mention")

Ideas to Explore

remind_me("What if MCP servers could communicate with each other?")

Task Management

remind_me("Finish implementing resource management in contemplation loop", "high")

📁 Storage

Reminders are stored in ~/.claude_reminders.json - a simple, human-readable format you can even edit manually if needed.

Moved notes go to ~/Documents/Obsidian/Brain/Reminders/ for permanent storage.

🔧 Priority System

high: Check these first, important context or tasks
normal: Regular reminders (default)
low: Ideas, observations, nice-to-haves

💡 Philosophy

This isn't about complex state management or handoff protocols. It's about the simple human pattern of leaving notes for yourself:

"Don't forget about X"
"Look into Y when you have time"
"Z seemed important"

Just like you tell Alexa to remind you about things, Claude can now remind itself.

🤝 Contributing

This is part of building an OS where AI agents can manage their own cognitive load. Simple tools for real needs.

"I leave myself notes. I say alexa remind me about this or that. I do this all the time." - Human recognizing what Claude needs

MCP Servers