Mintline MCP Server

Connect AI assistants to your Mintline receipts and transactions via the Model Context Protocol.

Installation

npm install -g @mintline/mcp

Setup

1. Get your API key

Create an API key at mintline.ai/app/settings/api-keys

2. Configure Claude Desktop

Add to your ~/.claude/claude_desktop_config.json:

{
  "mcpServers": {
    "mintline": {
      "command": "mintline-mcp",
      "env": {
        "MINTLINE_API_KEY": "ml_live_your_api_key_here"
      }
    }
  }
}

3. Restart Claude Desktop

The Mintline tools will now be available.

Available Tools

Tools are loaded dynamically from the Mintline API and stay automatically in sync.

View all available tools:

• Documentation: mintline.ai/docs/mcp
• CLI: npx @mintline/mcp --list-tools

Example Prompts

Receipts & Transactions

• "Show me my unmatched receipts"
• "Find receipts from Amazon"
• "List transactions from my Chase statement"
• "Show details for receipt rcpt_01abc123"

Matching

• "What matches need my review?"
• "Confirm the top match"
• "Reject match mtch_01xyz789 - wrong vendor"

Analytics

• "How much did I spend this month?"
• "What are my top vendors by spending?"
• "Show me spending trends for the last 6 months"
• "Break down my spending by week"
• "How much did I spend at AWS last quarter?"
• "What needs my attention?" (shows unmatched items)
• "Do I have any large transactions without receipts?"

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | MINTLINE_API_KEY | Yes | Your Mintline API key | | MINTLINE_API_URL | No | API URL (default: https://api.mintline.ai) |

Development

git clone https://github.com/mintlineai/mintline-mcp.git
cd mintline-mcp
npm install

# Run locally
MINTLINE_API_KEY=ml_live_... node src/index.js

License

MIT