MCP Reminders

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

This server cannot be installed

security - not tested

license - not found

quality - not tested

How are these scores calculated?

A simple system that allows Claude to leave and manage notes for itself across sessions, functioning like an 'Alexa, remind me...' for AI assistants.

Related MCP Servers

MCP Unified Server
getfounded
-
security
A
license
-
quality
A modular server implementation for Claude AI assistants with integrated tools, enabling Claude to perform actions and access external resources like file systems, web searches, browser automation, financial data, and document generation.
Last updated -
86
Python
MIT License
Memory Bank MCP Server
t3ta
-
security
A
license
-
quality
A server for managing project documentation and context across Claude AI sessions through global and branch-specific memory banks, enabling consistent knowledge management with structured JSON document storage.
Last updated -
10
11
TypeScript
MIT License
Knowledge Graph Memory Server
itseasy21
A
security
F
license
A
quality
An implementation of persistent memory for Claude using a local knowledge graph, allowing the AI to remember information about users across conversations with customizable storage location.
Last updated -
11
838
51
JavaScript
Notes MCP Server
daikw
A
security
F
license
A
quality
A simple note storage system that lets users create and summarize notes with varying detail levels using Claude.
Last updated -
1
1
Python

View all related MCP servers