{"id":"676309eb-575b-4622-a5e2-d3e0db323742","slug":"plaid-mcp","kind":"mcp","name":"plaid-mcp","summary":"","owner":"HEAL-Engineering","repoUrl":"https://github.com/HEAL-Engineering/plaid-mcp","license":"MIT","licenseTier":"permissive","trust":"community","stars":1,"match":null,"fewStars":true,"format":"mcp","createdAt":"2026-05-01T21:46:22.000Z","addedAt":"2026-10-21T21:06:57.424Z","logoUrl":"https://avatars.githubusercontent.com/u/231191861?v=4","linkOnly":false,"collection":null,"skillPath":null,"categories":["utilities"],"tags":[],"runtime":"python","local":true,"cloudCapable":false,"cloudCapability":"unknown","cloudReadyOnPlatform":false,"needsApiKey":false,"reviewed":false,"syncedAt":"2026-10-23T07:55:04.401Z","sample":false,"url":"https://conduits.dev/tools/plaid-mcp","language":"Python","transports":["stdio"],"install":{"pypi":"plaid-mcp"},"requirements":{"env":[],"upstreamMayCharge":false},"tools":null,"readme":"# plaid-mcp\n\nA Model Context Protocol (MCP) server that exposes Plaid sandbox transactions for AI agents.\n\n## Overview\n\nThis MCP server wraps Plaid's sandbox environment, providing 3 task-shaped tools that AI agents can use to query financial data without managing Plaid tokens directly.\n\n## Tools\n\n| Tool | Description | Arguments |\n|------|-------------|-----------|\n| `list_accounts` | Returns all sandbox accounts with balances | None |\n| `list_recent_transactions` | Returns recent transactions | `days_back: int (1-365, default 30)` |\n| `list_transactions_by_category` | Filtered transactions by category | `category: str`, `days_back: int` |\n\n## Quickstart\n\n### 1. Get Plaid Sandbox Credentials\n\n1. Sign up at https://dashboard.plaid.com/signup\n2. Navigate to **Developers → Keys**\n3. Copy your **client_id** and **Sandbox secret**\n\n### 2. Configure Environment\n\n```bash\ncp .env.example .env\n# Edit .env with your credentials\n```\n\n### 3. Install and Run\n\n```bash\n# Install dependencies\nuv sync\n\n# Run in stdio mode (for Claude Code / orchestrators)\nuv run python server.py\n\n# Or run in HTTP mode\nMCP_TRANSPORT=streamable-http uv run python server.py\n```\n\n## Use with Claude Code\n\n```bash\nclaude mcp add plaid-mcp uv run python /path/to/plaid-mcp/server.py\n```\n\nExample prompts:\n- \"What accounts do I have?\"\n- \"How much did I spend on food this month?\"\n- \"Show me my recent transactions\"\n\n## Use with Docker\n\n```bash\ndocker compose up\n```\n\nThe server will be available at `http://localhost:8001/mcp`.\n\n## Architecture\n\n- **Singleton token pattern**: The server mints a Plaid sandbox access token on first use and caches it at `.cache/plaid.json`. Agents don't need to manage tokens.\n- **Task-shaped tools**: 3 high-level tools instead of raw Plaid API endpoints.\n- **Dual transport**: stdio for subprocess orchestration, streamable-http for Docker/HTTP clients.\n\n## License\n\nMIT\n"}