🤖 Claude Desktop

Connect RewardSmart
to Claude Desktop

Use your credit card wallet directly in Claude conversations. Ask which card to use at any merchant, check expiring offers, and optimize rewards — all without leaving Claude.

🤖

Prerequisites

⭐

Elite Subscription

MCP requires a RewardSmart Elite plan. Upgrade here →

🔑

API Token

Generate in the RewardSmart app under Settings → Integrations → MCP Access.

🤖

Claude Desktop

Download and install from claude.ai/download. Version 0.7+ recommended.

đŸ“Ļ

Node.js 18+

Required to run the MCP server via npx. Download from nodejs.org.

1 Setup Instructions

  1. 1

    Get your RewardSmart API token

    Open the RewardSmart app on your phone. Go to Settings → Integrations → MCP Access and tap Generate Token. Copy the token — you'll need it in a moment.

    â„šī¸ Keep your token private. It grants access to your card data. You can revoke it at any time from the same settings screen.
  2. 2

    Open the Claude Desktop config file

    Navigate to the config file for your operating system. Create it if it doesn't exist yet.

    On macOS, the config file is located at:

    Path
    ~/Library/Application Support/Claude/claude_desktop_config.json

    Open Terminal and run:

    Terminal
    open ~/Library/Application\ Support/Claude/

    On Windows, the config file is located at:

    Path
    %APPDATA%\Claude\claude_desktop_config.json

    Open File Explorer and paste the path above into the address bar, or press Win + R and type %APPDATA%\Claude.

  3. 3

    Add the RewardSmart MCP server config

    Open claude_desktop_config.json in a text editor and add (or merge) the following. Replace YOUR_TOKEN_HERE with the token you copied in step 1.

    claude_desktop_config.json
    {
      "mcpServers": {
        "rewardsmart": {
          "command": "npx",
          "args": ["-y", "@rewardsmart/mcp-server"],
          "env": {
            "REWARDSMART_API_KEY": "YOUR_TOKEN_HERE"
          }
        }
      }
    }
    âš ī¸ If the file already has an "mcpServers" key, add the "rewardsmart" block inside it — don't duplicate the outer key.
  4. 4

    Restart Claude Desktop

    Fully quit and reopen Claude Desktop. On macOS use Cmd+Q, on Windows right-click the taskbar icon and choose Quit.

    After restarting, open a new conversation and look for the 🔌 MCP indicator or hammer icon in the chat input area. This confirms RewardSmart is connected.

  5. 5

    Test the connection

    Try asking Claude: "Which of my cards gives the best rewards at grocery stores?"

    ✅ If Claude responds with your actual card data, the integration is working perfectly!

What You Can Ask

Once connected, you can ask Claude natural language questions about your credit card rewards. Here are some examples to get you started:

Which card should I use at Target today?
What's my best card for dining out?
Do I have any offers expiring this week?
How much cashback did I earn last month?
Which card maximizes rewards for travel?
Show me all my active bonus categories.
What's the best card for gas stations?
Summarize my card benefits for Amazon.

Troubleshooting

MCP server not showing up in Claude

Make sure you've fully quit Claude Desktop (not just closed the window). Check that your JSON syntax is valid — missing commas or braces are the most common cause. Use a JSON validator like jsonlint.com to check.

"npx: command not found" error

Node.js is not installed or not in your PATH. Install Node.js 18+ from nodejs.org. After installing, restart Claude Desktop.

Authentication error / "Invalid API key"

Double-check that you replaced YOUR_TOKEN_HERE with your actual token. Tokens are long strings — make sure no characters were cut off when copying. You can regenerate a token in the RewardSmart app.

Claude says it can't access my cards

Ensure you have at least one card added to your RewardSmart wallet. Also check your Elite subscription is active in the RewardSmart app under Account → Subscription.

Config file doesn't exist

Create the directory and file manually. On macOS: mkdir -p ~/Library/Application\ Support/Claude && touch ~/Library/Application\ Support/Claude/claude_desktop_config.json. Then paste the JSON config and save.

Back to all MCP integrations