Metadata-Version: 2.3
Name: you-need-an-advisor-mcp
Version: 1.1.0
Summary: MCP server for YNAB -- your AI-powered budget advisor
Keywords: ynab,mcp,budget,model-context-protocol,advisor,ynaa
Author: Alex Levine
Author-email: Alex Levine <awlevine@pm.me>
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Office/Business :: Financial
Classifier: Typing :: Typed
Requires-Dist: fastmcp>=3.1.0
Requires-Dist: httpx>=0.28.1
Requires-Python: >=3.13
Project-URL: Documentation, https://senivel.github.io/you-need-an-advisor-mcp/
Project-URL: Repository, https://github.com/senivel/you-need-an-advisor-mcp
Project-URL: Issues, https://github.com/senivel/you-need-an-advisor-mcp/issues
Project-URL: Changelog, https://senivel.github.io/you-need-an-advisor-mcp/changelog/
Description-Content-Type: text/markdown

# You Need an Advisor MCP

**Not just API coverage -- a YNAB budgeting advisor powered by embedded methodology knowledge.**

An [MCP](https://modelcontextprotocol.io/) server that connects AI assistants like Claude to your [YNAB](https://www.ynab.com/) budget. Ask questions about your finances in natural language and get answers backed by real data from the YNAB API, informed by YNAB's budgeting methodology.

![Python 3.13+](https://img.shields.io/badge/python-3.13%2B-blue)
![License: MIT](https://img.shields.io/badge/license-MIT-green)

## Features

- **Full YNAB API coverage** -- Budgets, accounts, categories, transactions, payees, months, scheduled transactions
- **YNAB methodology built-in** -- Embedded knowledge of the Four Rules, overspending, credit cards, reconciliation, and Age of Money
- **Analysis & workflow prompts** -- Spending trends, budget health, debt payoff planning, and more
- **Secure** -- Your Personal Access Token stays on your machine; no data stored or forwarded

## Quick start

**1.** Get a [YNAB Personal Access Token](https://app.ynab.com/settings/developer)

**2.** Add to your Claude Desktop config (`claude_desktop_config.json`):

**With uvx (recommended):**

```json
{
  "mcpServers": {
    "ynab": {
      "command": "uvx",
      "args": ["you-need-an-advisor-mcp"],
      "env": {
        "YNAB_PAT": "your-token-here"
      }
    }
  }
}
```

**With Docker:**

```json
{
  "mcpServers": {
    "ynab": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "YNAB_PAT",
        "ghcr.io/senivel/you-need-an-advisor-mcp"
      ],
      "env": {
        "YNAB_PAT": "your-token-here"
      }
    }
  }
}
```

**3.** Ask Claude about your budget.

## Documentation

Full documentation: **[senivel.github.io/you-need-an-advisor-mcp](https://senivel.github.io/you-need-an-advisor-mcp/)**

## Links

- [Contributing](https://senivel.github.io/you-need-an-advisor-mcp/contributing/)
- [Changelog](https://senivel.github.io/you-need-an-advisor-mcp/contributing/changelog/)
- [License](LICENSE)
