Metadata-Version: 2.4
Name: reminderit-mcp
Version: 0.1.0
Summary: MCP server for ReminderIt — AI-powered phone call reminders
Project-URL: Homepage, https://reminderit.com
Project-URL: Repository, https://github.com/Venkatnvs/ReminderIt
License: MIT
Keywords: ai,claude,mcp,reminderit,reminders
Requires-Python: >=3.11
Requires-Dist: httpx>=0.27.0
Requires-Dist: mcp[cli]>=1.0.0
Requires-Dist: uvicorn>=0.30.0
Description-Content-Type: text/markdown

# reminderit-mcp

MCP server for [ReminderIt](https://reminderit.com) — lets Claude manage your phone call reminders via natural language.

## What it does

Gives Claude (or any MCP client) 8 tools:

| Tool | What it does |
|---|---|
| `list_reminders` | Show all reminders with schedule and status |
| `get_reminder` | Full detail on one reminder |
| `create_reminder` | Schedule a new phone call (once or recurring) |
| `update_reminder` | Change title, message, schedule, pause/resume |
| `delete_reminder` | Remove permanently |
| `get_usage` | Quota, calls used, plan, billing period |
| `list_recipients` | Caregiving recipients |
| `get_recent_calls` | Delivery logs — answered/failed/no-answer |

## Setup

**1. Get an API key** — Sign up at [reminderit.com](https://reminderit.com), then go to **API Keys** in your dashboard.

**2. Install**

```bash
pip install reminderit-mcp
```

**3. Add to Claude Desktop** (`~/Library/Application Support/Claude/claude_desktop_config.json` on Mac):

```json
{
  "mcpServers": {
    "reminderit": {
      "command": "reminderit-mcp",
      "env": {
        "REMINDERIT_API_KEY": "rmt_your_key_here",
        "REMINDERIT_API_URL": "https://api.reminderit.com"
      }
    }
  }
}
```

**4. Restart Claude Desktop** and try:

> *"Set a daily medication reminder at 8am London time"*
> *"What reminders do I have active?"*
> *"Cancel my 6:30am wake-up call"*
> *"How many calls have I used this month?"*

## Environment variables

| Variable | Required | Default |
|---|---|---|
| `REMINDERIT_API_KEY` | Yes | — |
| `REMINDERIT_API_URL` | No | `https://api.reminderit.com` |

## HTTP mode (self-hosted)

To run as an HTTP server instead of stdio:

```bash
REMINDERIT_API_KEY=rmt_... reminderit-mcp http
```

Listens on port 8080 (override with `PORT` env var).
