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