Reminders

You can run a lightweight MCP server that lets Claude leave and manage reminders across sessions. This reminder system is designed to be simple and practical: you tell Claude to remind you about something, check what’s waiting, and act on items later. It helps you maintain a lightweight cognitive footprint by storing notes you want to revisit without complex handoffs.

How to use

To use this MCP server with an MCP client, start a session and check for pending reminders before you begin any task. You can create reminders with a priority level to signal urgency, review your high-priority items first, and manage or move items to a more permanent note store as needed.

Key actions you can perform include creating reminders with optional priority, listing current reminders, marking items as done, deleting items, and saving notes permanently for future reference. Priorities help you surface the most important context or tasks first.

How to install

Prerequisites: you need Node.js installed on your system. You will also need a shell to run the setup commands.

# 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 to run the reminders MCP as a local process. Use the following configuration snippet to add the MCP server entry. This tells Claude to execute the built index when starting the session.

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

Additional sections

Storage and data management: Reminders are stored in ~/.claude_reminders.json in a human‑readable format. Finished or important notes can be moved to a permanent storage location, such as ~/Documents/Obsidian/Brain/Reminders/ for long‑term access.

Priority system: Use high, normal, or low to categorize reminders. High priority should be reviewed first, normal is for regular reminders, and low is for ideas or nice‑to‑haves.

Philosophy: Keep the interaction simple. Leave notes for yourself just as you would set a reminder with a voice assistant—concise, actionable, and revisitable across sessions.

Tools available: You can create, view, complete, delete, move to permanent notes, and clean up old completed reminders. These operations help you manage your cognitive load without introducing heavy state management.

Available tools

check_reminders

Query the reminders you have waiting, with an optional priority filter to show only high-priority items when starting a session.

remind_me

Create a new reminder with optional priority to have Claude present a note across sessions.

complete_reminder

Mark a reminder as completed, so it can be filtered out from active lists.

delete_reminder

Remove a reminder entirely without marking it as completed.

move_to_notes

Save a reminder permanently to a notes store for long-term reference.

clear_old_reminders

Clean up old completed reminders to keep the list focused and manageable.