Minted

You run a Minted MCP Server to interact with the Minted.com API, giving you programmatic access to your address book, delivery information, and order history. This server handles authentication via Selenium, caches session cookies for the duration of the process, and exposes endpoints you can call from your MCP client.

How to use

To use this MCP server, configure your MCP client to run the local script and connect via stdio. You will be able to fetch all Minted contacts, retrieve delivery details from the latest order, and query your Minted order history. Use the provided tool names to request data and handle responses in your client.

Run calls from your MCP client by invoking the minted server as a local stdio process. The server authenticates on the first operation, stores session cookies in memory, and uses them for subsequent requests within the same session.

How to install

Prerequisites: you need Python installed, and access to install Python dependencies.

cd mcp-servers/minted
pip install -r requirements.txt

Configuration

Set up credentials and how to run the server through your MCP client. The server can fetch credentials from 1Password, from environment variables, or prompt you interactively if credentials are missing.

Credential options shown in examples below are the ones you can use to start the server from your MCP client.

{
  "mcpServers": {
    "minted": {
      "command": "python",
      "args": [
        "$REPO_ROOT/mcp-servers/minted/minted_mcp_server.py"
      ],
      "env": {
        "minted_email": "your@email.com",
        "minted_password": "yourpassword"
      }
    }
  }
}

Alternative: use 1Password integration to supply credentials securely. The client configuration remains the same, but the env can be empty when using the integration.

{
  "mcpServers": {
    "minted": {
      "command": "python",
      "args": [
        "$REPO_ROOT/mcp-servers/minted/minted_mcp_server.py"
      ],
      "env": {}
    }
  }
}

{
  "mcpServers": {
    "minted": {
      "command": "python",
      "args": [
        "$REPO_ROOT/mcp-servers/minted/minted_mcp_server.py"
      ],
      "env": {}
    }
  }
}

Claude Desktop Configuration

{
  "mcpServers": {
    "minted": {
      "command": "python",
      "args": [
        "$REPO_ROOT/mcp-servers/minted/minted_mcp_server.py"
      ]
    }
  }
}

What you can do with Minted MCP

You can retrieve data using the following tools exposed by the server. Each tool returns a structured JSON payload with status and data fields.

• get_minted_contacts: Fetch all contacts from Minted address book, including id, name, and address fields.

• get_minted_latest_delivery: Retrieve recipients and delivery details from the most recent Minted card delivery or order.

• get_minted_orders: Get your Minted order history with optional limiting of results.

Security and reliability

Credentials are never logged. Session cookies are stored in memory for the lifetime of the server process. All network requests occur only to minted.com domains.

Use 1Password integration for secure credential management when possible.

Troubleshooting

Authentication happens on the first API call and cookies are cached for subsequent requests in the same session. If authentication fails, verify the credentials, ensure the login flow structure hasn’t changed, and retry. If API endpoints appear missing, check for changes in Minted’s API structure and update minted_mcp_server.py accordingly.

Selenium relies on Chrome/Chromium being installed. The driver is managed automatically. If headless mode causes issues, try running without headless temporarily.

Available tools

get_minted_contacts

Fetch all contacts from Minted address book and return a list with fields like id, name, address1, city, state, zip.

get_minted_latest_delivery

Retrieve recipients and delivery details from the most recent Minted card delivery or order, including delivery date, order id, status, and recipient information.

get_minted_orders

Return Minted order history with an optional limit on the number of orders.