pip install reminderit-mcp: a developer guide to the MCP package

reminderit-mcp is a Python package that implements the ReminderIt MCP server. It ships two transport modes — stdio for Claude Desktop and HTTP for hosted, multi-user deployments — and is published on PyPI so you can install it with a single command.

Installation

pip install reminderit-mcp installs the package and registers the reminderit-mcp CLI entry point. Requires Python 3.11 or higher. Dependencies: mcp[cli], httpx, uvicorn.

Stdio mode (Claude Desktop)

Set REMINDERIT_API_KEY in your environment (or in the Claude Desktop config's env object) and run reminderit-mcp or reminderit-mcp stdio. The server reads JSON-RPC from stdin and writes responses to stdout — exactly how Claude Desktop expects it. Each call uses the single API key in the environment.

HTTP mode (hosted, multi-user)

Run reminderit-mcp http to start a Starlette/Uvicorn server on port 8080 (override with PORT env var). Each request must carry Authorization: Bearer rmt_xxx or X-API-Key: rmt_xxx — the key is resolved per-request, not from the environment. This is how https://mcp.reminderit.com runs.

The HTTP server exposes: POST /mcp (MCP streamable-HTTP), GET /health, GET /.well-known/oauth-authorization-server, POST /.well-known/oauth-authorization-server is at the api subdomain.

Extending the server

The server is built with FastMCP. You can fork the repo, add tools via @mcp.tool() decorators, and rebuild. The package uses the ReminderIt REST API under the hood — any endpoint available in the API can be wrapped as an MCP tool in a few lines.