Skip to main content

MCP server for YNAB -- your AI-powered budget advisor

Project description

You Need an Advisor MCP

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

An MCP server that connects AI assistants like Claude to your YNAB 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.

PyPI Python License

CI Docs Pyright Ruff

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

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

With uvx (recommended):

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

With Docker:

{
  "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

Links

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

you_need_an_advisor_mcp-1.1.3.tar.gz (61.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

you_need_an_advisor_mcp-1.1.3-py3-none-any.whl (86.4 kB view details)

Uploaded Python 3

File details

Details for the file you_need_an_advisor_mcp-1.1.3.tar.gz.

File metadata

  • Download URL: you_need_an_advisor_mcp-1.1.3.tar.gz
  • Upload date:
  • Size: 61.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for you_need_an_advisor_mcp-1.1.3.tar.gz
Algorithm Hash digest
SHA256 f4b11e7b414700855194687ddbb2d20c32cab155f5e03adb7975a11929c47fd2
MD5 79507695e0af4603c378262b63139b90
BLAKE2b-256 0ce01aba8c276fe5b07a44fbd85219ebb3d035dcec455298878dd0377347f5b6

See more details on using hashes here.

Provenance

The following attestation bundles were made for you_need_an_advisor_mcp-1.1.3.tar.gz:

Publisher: publish.yml on senivel/you-need-an-advisor-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file you_need_an_advisor_mcp-1.1.3-py3-none-any.whl.

File metadata

File hashes

Hashes for you_need_an_advisor_mcp-1.1.3-py3-none-any.whl
Algorithm Hash digest
SHA256 065f4855c8676e444f17d99d6a0eb6320d46cc4982e82e0b898503b77933ff10
MD5 9193e97b6bbc68442915a5c560d44331
BLAKE2b-256 4d97b14b4891355bd99904f8b4e86050f98627c38a22254763abb1afe6286810

See more details on using hashes here.

Provenance

The following attestation bundles were made for you_need_an_advisor_mcp-1.1.3-py3-none-any.whl:

Publisher: publish.yml on senivel/you-need-an-advisor-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page