@keepmysubs/mcp

@keepmysubs/mcp

An MCP server that lets AI assistants (Claude Desktop, Cursor, OpenAI Codex CLI, etc.) read and manage your KeepMySubs subscriptions over the KeepMySubs Agent API. It runs locally over stdio and talks to the KeepMySubs API using a personal API key.

Prefer no API key? KeepMySubs also runs a hosted, OAuth-authenticated MCP server at https://keepmysubs.com/mcp — connect it from ChatGPT (developer mode) or Codex (codex mcp add … --url) and authorize in the browser instead of managing a key. See the Codex CLI section below and docs/distribution/openai-codex-submission.md.

Setup

1. Create an API key

In the KeepMySubs web app, go to Settings → API keys and create a new key. Copy it — it looks like kms_live_… and is shown only once.

2. Add it to your MCP client config

Add the server to your MCP client's config (for Claude Desktop, this is claude_desktop_config.json):

{
  "mcpServers": {
    "keepmysubs": {
      "command": "npx",
      "args": ["-y", "@keepmysubs/mcp"],
      "env": {
        "KMS_API_KEY": "kms_live_…"
      }
    }
  }
}

Restart your MCP client. If KMS_API_KEY is missing the server exits immediately with a message telling you to set it.

Overriding the host

By default the server talks to the production KeepMySubs API. Set KMS_BASE_URL in the env block to point at a different host (for example a staging or local instance).

Codex CLI

OpenAI Codex supports MCP servers two ways.

Run this package over stdio (API key):

codex mcp add keepmysubs --env KMS_API_KEY=kms_live_… -- npx -y @keepmysubs/mcp

Or connect the hosted server over OAuth (no API key):

codex mcp add keepmysubs --url https://keepmysubs.com/mcp
codex mcp login keepmysubs        # opens the browser to authorize

List and verify with codex mcp list. The OAuth route uses the same consent screen as every other KeepMySubs connector.

Tools

The server exposes 15 tools: list_subscriptions, get_subscription, create_subscription, update_subscription, delete_subscription, get_spend_summary, list_upcoming_renewals, list_recent_charges, record_charge, list_alerts, dismiss_alert, list_pending_bills, accept_bill, reject_bill, and parse_bill.