io.github.mintlineai/mintline-mcp
Connect AI assistants to your Mintline receipts, transactions, and spending analytics.
Open source Open in the app JSON README (API)
About
Connect AI assistants to your Mintline receipts, transactions, and spending analytics.
Details
- Kind
- MCP servers
- Topic
- Marketing & analytics
- Publisher
- mintlineai
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 1.1.9
- Last push
- 2026-02-04T12:14:28Z
- Repository state
- ativo
- Language
- JavaScript
- Added
- 2026-08-29 04:00:48
- Updated
- 2026-08-29 04:00:48
- Origin id
io.github.mintlineai/mintline-mcp
README
# Mintline MCP Server
Connect AI assistants to your Mintline receipts and transactions via the [Model Context Protocol](https://modelcontextprotocol.io).
[](https://registry.modelcontextprotocol.io/servers/io.github.mintlineai/mintline-mcp)
[](https://mcp.so/server/mintline-mcp)
[](https://www.npmjs.com/package/@mintline/mcp)
## Installation
```bash
npm install -g @mintline/mcp
```
## Setup
### 1. Get your API key
Create an API key at [mintline.ai/app/settings/api-keys](https://mintline.ai/app/settings/api-keys)
### 2. Configure Claude Desktop
Add to your `~/.claude/claude_desktop_config.json`:
```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](https://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
```bash
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