Skip to main content
Glama
Sign In
monarch-mcp2

monarch-mcp2

by erikrubstein
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

monarch-mcp2

Unofficial MCP server for Monarch Money.

This project is not affiliated with, endorsed by, or supported by Monarch Money.

monarch-mcp2 gives agents like Codex and Claude access to Monarch Money through Model Context Protocol tools. It exposes the public function surface from monarch-api2, organized by Monarch feature area, with tool names that map 1-to-1 to backend API functions:

{group}_{function_name}

Features

  • MCP tools backed directly by monarch-api2, not the CLI

  • 1-to-1 tool names matching the API function surface

  • Typed input schemas for filters, enums, nested objects, and mutations

  • Tool annotations for read-only, write, and destructive operations

  • Compact summary output by default, similar to the CLI's table/detail views

  • full output when agents need the complete structured API data

  • raw output when agents explicitly need retained raw response payloads

  • Dotted-path field projection for targeted output

  • Tools for auth, accounts, transactions, receipts, cashflow, reports, merchants, tags, household, categories, recurring items, investments, goals, and budgets

Related MCP server: Monarch Money MCP Server

Installation

This package depends on monarch-api2 version 0.1.0, installed directly from GitHub:

monarch-api2 @ git+https://github.com/erikrubstein/monarch-api2.git@v0.1.0

Install the MCP server from GitHub:

pipx install git+https://github.com/erikrubstein/monarch-mcp2.git

After installation, confirm the monarch-mcp command is available:

which monarch-mcp

Codex

Add the server to Codex:

codex mcp add monarch -- monarch-mcp

If your session file is somewhere other than the default path, include MONARCH_SESSION_PATH:

codex mcp add \
  --env MONARCH_SESSION_PATH="/absolute/path/to/session.json" \
  monarch \
  -- monarch-mcp

Verify the server was added:

codex mcp list

Restart Codex after adding the server. Once loaded, Codex should see tools such as accounts_list_accounts, transactions_list_transactions, and budget_get_budget.

Claude Code

Add the server to Claude Code:

claude mcp add --scope user monarch -- monarch-mcp

If your session file is somewhere other than the default path, include MONARCH_SESSION_PATH:

claude mcp add \
  --scope user \
  -e MONARCH_SESSION_PATH="/absolute/path/to/session.json" \
  monarch \
  -- monarch-mcp

Verify the server was added:

claude mcp list

Restart Claude Code after adding the server.

Claude Desktop

Claude Desktop uses a JSON config file rather than the Claude Code claude mcp command.

On macOS, the config file is usually:

~/Library/Application Support/Claude/claude_desktop_config.json

Example:

{
  "mcpServers": {
    "monarch": {
      "command": "/absolute/path/to/monarch-mcp",
      "args": [],
      "env": {
        "MONARCH_SESSION_PATH": "/absolute/path/to/session.json"
      }
    }
  }
}

Restart Claude Desktop after editing the config.

Sessions

The default session file is:

~/.config/monarch/session.json

You can override it with MONARCH_SESSION_PATH, or set MONARCH_CONFIG_DIR to change the config directory.

Use auth_create_session to create a Monarch session. Auth tools redact the session token by default. Set include_token=true only when a trusted caller explicitly needs the bearer token, such as when saving a session.

You can also provide a session file created by monarch-api2, monarch-cli2, or another trusted tool. The MCP server loads the configured session file for authenticated tools.

MCP Inspector

You can inspect the server with MCP Inspector:

npx @modelcontextprotocol/inspector /absolute/path/to/monarch-mcp

If Inspector asks for transport details, use stdio with:

{
  "command": "/absolute/path/to/monarch-mcp",
  "args": [],
  "env": {
    "MONARCH_SESSION_PATH": "/absolute/path/to/session.json"
  }
}

Tools

Tool names mirror monarch-api2 function names:

auth_create_session
accounts_list_accounts
transactions_list_transactions
transactions_get_transaction
receipts_list_receipts
cashflow_get_cashflow_summary
reports_get_report_data
merchants_list_merchants
tags_list_tags
household_get_current_user
categories_list_categories
recurring_list_recurring_streams
investments_get_portfolio
goals_list_goals
budget_get_budget

The full server currently exposes 125 tools across all implemented API groups. Use an MCP client or MCP Inspector to browse the complete tool list and schemas.

receipts_list_receipts returns uploaded and emailed receipts by default. Its optional filters.source value can be upload or email.

Output

By default, tools return compact summary output. This is intended for agent workflows where the caller usually needs the same fundamental fields a person would scan in the CLI.

All tools accept common output controls:

  • output_mode="summary" returns compact CLI-style output.

  • output_mode="full" returns complete structured API output without raw.

  • output_mode="raw" returns complete structured API output including raw.

  • fields=[...] returns only selected dotted-path fields.

Examples:

{
  "limit": 10
}
{
  "limit": 10,
  "output_mode": "full"
}
{
  "transaction_id": "TRANSACTION_ID",
  "output_mode": "raw"
}
{
  "limit": 10,
  "output_mode": "raw",
  "fields": ["id", "date", "merchant.name", "category.name", "raw"]
}

When fields is provided, it is applied to the selected full/raw data and the tool returns the projected object directly.

Transaction Review Skill

This repo includes a Codex skill at:

skills/monarch-transaction-review

The skill helps agents prepare unreviewed Monarch transactions without marking them reviewed. It uses workflow tags such as AI Prepared and AI Needs Context, then leaves the Monarch review status for the human review stage. It keeps private learned preferences in:

~/.config/monarch/transaction-review-memory.md

Install or reference the skill from your Codex skills directory when you want agents to use the transaction review workflow automatically.

Development

Run the test suite:

.venv/bin/python -m pytest

The MCP source lives in src/monarch_mcp. Group-specific tools live in src/monarch_mcp/groups.

Security

This is an unofficial tool that can access sensitive personal finance data. Treat saved session files like passwords.

  • Do not commit session files, tokens, downloaded receipts, or personal finance exports.

  • Use output_mode="raw" carefully, since raw payloads may include large or sensitive response data.

  • Only connect this server to trusted MCP clients.

  • Report security-sensitive issues privately instead of opening a public issue with credentials or personal financial data.

License

MIT License. See LICENSE.

Available Tools

125 tools
accounts_create_manual_accountAccounts Create Manual AccountC

Create manual account. This may create or update Monarch data.

Inputs: name (required), type (required), subtype (required), fields, +5 more.

accounts_delete_accountAccounts Delete AccountB
Destructive

Delete account. This may delete, clear, reset, or otherwise remove data.

Inputs: account_id (required), fields, output_mode, session_path.

accounts_get_accountAccounts Get AccountC
Read-onlyIdempotent

Get account.

Inputs: account_id (required), fields, output_mode, session_path.

accounts_get_account_historyAccounts Get Account HistoryD
Read-onlyIdempotent

Get account history.

Inputs: account_id (required), fields, output_mode, session_path.

accounts_get_historical_balancesAccounts Get Historical BalancesD
Read-onlyIdempotent

Get historical balances.

Inputs: balance_date (required), fields, filters, output_mode, +1 more.

accounts_get_net_worth_breakdownAccounts Get Net Worth BreakdownC
Read-onlyIdempotent

Get net worth breakdown.

Inputs: timeframe (required), start_date (required), fields, filters, +2 more.

accounts_get_net_worth_performanceAccounts Get Net Worth PerformanceC
Read-onlyIdempotent

Get net worth performance.

Inputs: fields, filters, end_date, start_date, +3 more.

accounts_list_accountsAccounts List AccountsC
Read-onlyIdempotent

List accounts.

Inputs: fields, filters, output_mode, session_path.

accounts_update_accountAccounts Update AccountC

Update account. This may create or update Monarch data.

Inputs: account_id (required), name, type, fields, +9 more.

auth_create_sessionAuth Create SessionC

Create session. This may create or update Monarch data.

Inputs: email (required), password (required), fields, mfa_code, +4 more.

auth_load_sessionAuth Load SessionC
Read-onlyIdempotent

Load session.

Inputs: path (required), fields, output_mode, include_token.

auth_save_sessionAuth Save SessionC

Save session. This may create or update Monarch data.

Inputs: path (required), session (required), fields, output_mode.

budget_clear_budgetBudget Clear BudgetC
Destructive

Clear budget. This may delete, clear, reset, or otherwise remove data.

Inputs: month (required), fields, confirm, output_mode, +1 more.

budget_create_budgetBudget Create BudgetC

Create budget. This may create or update Monarch data.

Inputs: month (required), fields, output_mode, session_path.

budget_get_budgetBudget Get BudgetD
Read-onlyIdempotent

Get budget.

Inputs: month (required), fields, output_mode, session_path.

budget_get_budget_categoryBudget Get Budget CategoryC
Read-onlyIdempotent

Get budget category.

Inputs: month (required), category_id (required), fields, output_mode, +1 more.

budget_get_budget_settingsBudget Get Budget SettingsB
Read-onlyIdempotent

Get budget settings.

Inputs: fields, output_mode, session_path.

budget_get_flex_rollover_settingsBudget Get Flex Rollover SettingsB
Read-onlyIdempotent

Get flex rollover settings.

Inputs: fields, output_mode, session_path.

budget_list_budget_monthsBudget List Budget MonthsC
Read-onlyIdempotent

List budget months.

Inputs: end_month (required), start_month (required), fields, output_mode, +1 more.

budget_reset_budgetBudget Reset BudgetD
Destructive

Reset budget. This may delete, clear, reset, or otherwise remove data.

Inputs: month (required), fields, output_mode, category_ids, +4 more.

budget_reset_budget_rolloverBudget Reset Budget RolloverC
Destructive

Reset budget rollover. This may delete, clear, reset, or otherwise remove data.

Inputs: month (required), fields, category_id, output_mode, +3 more.

budget_set_budget_amountBudget Set Budget AmountC

Set budget amount. This may create or update Monarch data.

Inputs: month (required), amount (required), category_id (required), fields, +4 more.

budget_set_budget_category_rolloverBudget Set Budget Category RolloverC

Set budget category rollover. This may create or update Monarch data.

Inputs: enabled (required), category_id (required), fields, frequency, +7 more.

budget_set_budget_category_variabilityBudget Set Budget Category VariabilityC

Set budget category variability. This may create or update Monarch data.

Inputs: category_id (required), variability (required), fields, output_mode, +1 more.

budget_set_budget_group_amountBudget Set Budget Group AmountC

Set budget group amount. This may create or update Monarch data.

Inputs: month (required), amount (required), category_group_id (required), fields, +4 more.

budget_set_budget_group_rolloverBudget Set Budget Group RolloverC

Set budget group rollover. This may create or update Monarch data.

Inputs: enabled (required), category_group_id (required), fields, output_mode, +4 more.

budget_set_budget_group_variabilityBudget Set Budget Group VariabilityC

Set budget group variability. This may create or update Monarch data.

Inputs: variability (required), category_group_id (required), fields, output_mode, +1 more.

budget_set_flex_budget_amountBudget Set Flex Budget AmountC

Set flex budget amount. This may create or update Monarch data.

Inputs: month (required), amount (required), fields, output_mode, +3 more.

budget_set_flex_rollover_settingsBudget Set Flex Rollover SettingsC

Set flex rollover settings. This may create or update Monarch data.

Inputs: enabled (required), fields, output_mode, start_month, +2 more.

cashflow_get_cashflow_breakdownCashflow Get Cashflow BreakdownD
Read-onlyIdempotent

Get cashflow breakdown.

Inputs: end_date (required), direction (required), start_date (required), fields, +4 more.

cashflow_get_cashflow_summaryCashflow Get Cashflow SummaryC
Read-onlyIdempotent

Get cashflow summary.

Inputs: end_date (required), start_date (required), fields, filters, +2 more.

cashflow_get_cashflow_trendsCashflow Get Cashflow TrendsC
Read-onlyIdempotent

Get cashflow trends.

Inputs: end_date (required), start_date (required), fields, filters, +3 more.

categories_create_categoryCategories Create CategoryC

Create category. This may create or update Monarch data.

Inputs: icon (required), name (required), group_id (required), fields, +2 more.

categories_create_category_groupCategories Create Category GroupB

Create category group. This may create or update Monarch data.

Inputs: name (required), type (required), fields, output_mode, +1 more.

categories_delete_category_groupCategories Delete Category GroupC
Destructive

Delete category group. This may delete, clear, reset, or otherwise remove data.

Inputs: group_id (required), fields, output_mode, session_path, +1 more.

categories_get_categoryCategories Get CategoryC
Read-onlyIdempotent

Get category.

Inputs: category_id (required), fields, output_mode, session_path.

categories_get_category_catalogCategories Get Category CatalogC
Read-onlyIdempotent

Get category catalog.

Inputs: fields, output_mode, session_path, include_disabled.

categories_get_category_groupCategories Get Category GroupB
Read-onlyIdempotent

Get category group.

Inputs: group_id (required), fields, output_mode, session_path.

categories_list_categoriesCategories List CategoriesB
Read-onlyIdempotent

List categories.

Inputs: fields, filters, output_mode, session_path, +1 more.

categories_list_category_groupsCategories List Category GroupsC
Read-onlyIdempotent

List category groups.

Inputs: fields, output_mode, session_path.

categories_reactivate_categoryCategories Reactivate CategoryB

Reactivate category. This may create or update Monarch data.

Inputs: category_id (required), fields, output_mode, session_path.

categories_remove_categoryCategories Remove CategoryC
Destructive

Remove category. This may delete, clear, reset, or otherwise remove data.

Inputs: category_id (required), fields, output_mode, session_path, +1 more.

categories_reorder_categoryCategories Reorder CategoryC

Reorder category. This may create or update Monarch data.

Inputs: order (required), group_id (required), category_id (required), fields, +2 more.

categories_reorder_category_groupCategories Reorder Category GroupC

Reorder category group. This may create or update Monarch data.

Inputs: order (required), group_id (required), fields, output_mode, +1 more.

categories_update_categoryCategories Update CategoryC

Update category. This may create or update Monarch data.

Inputs: category_id (required), icon, name, fields, +3 more.

categories_update_category_groupCategories Update Category GroupC

Update category group. This may create or update Monarch data.

Inputs: group_id (required), name, type, fields, +2 more.

goals_archive_goalGoals Archive GoalC

Archive goal. This may create or update Monarch data.

Inputs: goal_id (required), fields, output_mode, session_path.

goals_contribute_to_goalGoals Contribute To GoalC

Contribute to goal. This may create or update Monarch data.

Inputs: amount (required), goal_id (required), account_id (required), date, +5 more.

goals_create_goalGoals Create GoalC

Create goal. This may create or update Monarch data.

Inputs: name (required), fields, priority, goal_type, +8 more.

goals_delete_goalGoals Delete GoalC
Destructive

Delete goal. This may delete, clear, reset, or otherwise remove data.

Inputs: goal_id (required), fields, output_mode, session_path.

goals_delete_goal_eventGoals Delete Goal EventC
Destructive

Delete goal event. This may delete, clear, reset, or otherwise remove data.

Inputs: event_id (required), fields, output_mode, session_path.

goals_get_goalGoals Get GoalD
Read-onlyIdempotent

Get goal.

Inputs: goal_id (required), fields, output_mode, session_path.

goals_get_goal_budget_amountsGoals Get Goal Budget AmountsD
Read-onlyIdempotent

Get goal budget amounts.

Inputs: goal_id (required), end_month (required), start_month (required), fields, +2 more.

goals_link_goal_account_balanceGoals Link Goal Account BalanceC

Link goal account balance. This may create or update Monarch data.

Inputs: goal_id (required), account_id (required), amount, fields, +3 more.

goals_list_goal_eventsGoals List Goal EventsC
Read-onlyIdempotent

List goal events.

Inputs: goal_id (required), fields, output_mode, session_path.

goals_list_goalsGoals List GoalsC
Read-onlyIdempotent

List goals.

Inputs: fields, output_mode, session_path, include_archived.

goals_restore_goalGoals Restore GoalB

Restore goal. This may create or update Monarch data.

Inputs: goal_id (required), fields, output_mode, session_path.

goals_set_goal_budget_amountGoals Set Goal Budget AmountB

Set goal budget amount. This may create or update Monarch data.

Inputs: month (required), amount (required), goal_id (required), fields, +4 more.

goals_unlink_goal_accountGoals Unlink Goal AccountC

Unlink goal account. This may create or update Monarch data.

Inputs: goal_id (required), account_id (required), fields, output_mode, +1 more.

goals_update_goalGoals Update GoalC

Update goal. This may create or update Monarch data.

Inputs: goal_id (required), name, fields, status, +10 more.

goals_update_goal_eventGoals Update Goal EventB

Update goal event. This may create or update Monarch data.

Inputs: event_id (required), date, notes, fields, +3 more.

goals_update_goal_prioritiesGoals Update Goal PrioritiesC

Update goal priorities. This may create or update Monarch data.

Inputs: goal_ids (required), fields, output_mode, session_path.

goals_withdraw_from_goalGoals Withdraw From GoalC

Withdraw from goal. This may create or update Monarch data.

Inputs: amount (required), goal_id (required), account_id (required), date, +5 more.

household_get_current_userHousehold Get Current UserD
Read-onlyIdempotent

Get current user.

Inputs: fields, output_mode, session_path.

household_get_householdHousehold Get HouseholdD
Read-onlyIdempotent

Get household.

Inputs: fields, output_mode, session_path.

household_get_household_memberHousehold Get Household MemberC
Read-onlyIdempotent

Get household member.

Inputs: member_id (required), fields, output_mode, session_path.

household_get_household_preferencesHousehold Get Household PreferencesC
Read-onlyIdempotent

Get household preferences.

Inputs: fields, output_mode, session_path.

household_list_household_membersHousehold List Household MembersC
Read-onlyIdempotent

List household members.

Inputs: fields, output_mode, session_path.

household_update_current_userHousehold Update Current UserC

Update current user. This may create or update Monarch data.

Inputs: fields, timezone, output_mode, display_name, +1 more.

household_update_household_preferencesHousehold Update Household PreferencesC

Update household preferences. This may create or update Monarch data.

Inputs: fields, output_mode, session_path, exclude_business_from_budget, +4 more.

investments_create_manual_holdingInvestments Create Manual HoldingC

Create manual holding. This may create or update Monarch data.

Inputs: quantity (required), account_id (required), security_id (required), fields, +3 more.

investments_delete_manual_holdingInvestments Delete Manual HoldingC
Destructive

Delete manual holding. This may delete, clear, reset, or otherwise remove data.

Inputs: holding_id (required), fields, output_mode, session_path.

investments_get_holdingInvestments Get HoldingD
Read-onlyIdempotent

Get holding.

Inputs: holding_id (required), fields, output_mode, session_path.

investments_get_holding_performanceInvestments Get Holding PerformanceC
Read-onlyIdempotent

Get holding performance.

Inputs: holding_id (required), fields, end_date, start_date, +2 more.

investments_get_portfolioInvestments Get PortfolioD
Read-onlyIdempotent

Get portfolio.

Inputs: fields, end_date, start_date, account_ids, +4 more.

investments_get_securityInvestments Get SecurityD
Read-onlyIdempotent

Get security.

Inputs: security_id (required), fields, output_mode, session_path.

investments_list_holdingsInvestments List HoldingsC
Read-onlyIdempotent

List holdings.

Inputs: fields, account_ids, output_mode, session_path, +1 more.

investments_list_investment_accountsInvestments List Investment AccountsC
Read-onlyIdempotent

List investment accounts.

Inputs: fields, output_mode, session_path.

investments_search_securitiesInvestments Search SecuritiesC
Read-onlyIdempotent

Search securities.

Inputs: query (required), limit, fields, output_mode, +2 more.

investments_update_manual_holdingInvestments Update Manual HoldingC

Update manual holding. This may create or update Monarch data.

Inputs: holding_id (required), fields, quantity, cost_basis, +3 more.

merchants_delete_merchantMerchants Delete MerchantC
Destructive

Delete merchant. This may delete, clear, reset, or otherwise remove data.

Inputs: merchant_id (required), fields, output_mode, session_path, +1 more.

merchants_get_merchantMerchants Get MerchantC
Read-onlyIdempotent

Get merchant.

Inputs: merchant_id (required), fields, output_mode, session_path.

merchants_list_merchantsMerchants List MerchantsC
Read-onlyIdempotent

List merchants.

Inputs: sort, limit, fields, offset, +3 more.

merchants_update_merchantMerchants Update MerchantC

Update merchant. This may create or update Monarch data.

Inputs: merchant_id (required), name, fields, output_mode, +1 more.

receipts_delete_receiptReceipts Delete ReceiptC
Destructive

Delete receipt. This may delete, clear, reset, or otherwise remove data.

Inputs: receipt_id (required), fields, output_mode, session_path.

receipts_get_receiptReceipts Get ReceiptC
Read-onlyIdempotent

Get receipt.

Inputs: receipt_id (required), fields, output_mode, session_path.

receipts_get_receipt_settingsReceipts Get Receipt SettingsC
Read-onlyIdempotent

Get receipt settings.

Inputs: fields, output_mode, session_path.

receipts_list_receiptsReceipts List ReceiptsA
Read-onlyIdempotent

List uploaded and emailed receipts, optionally filtered by source or status.

Inputs: limit, fields, offset, filters, +2 more.

receipts_match_receiptReceipts Match ReceiptC

Match receipt. This may create or update Monarch data.

Inputs: receipt_id (required), transaction_id (required), fields, output_mode, +1 more.

receipts_unmatch_receiptReceipts Unmatch ReceiptB

Unmatch receipt. This may create or update Monarch data.

Inputs: receipt_id (required), fields, output_mode, session_path.

receipts_update_receiptReceipts Update ReceiptC

Update receipt. This may create or update Monarch data.

Inputs: receipt_id (required), tax, tip, date, +9 more.

receipts_update_receipt_settingsReceipts Update Receipt SettingsC

Update receipt settings. This may create or update Monarch data.

Inputs: fields, output_mode, session_path, auto_categorize, +1 more.

receipts_upload_receiptReceipts Upload ReceiptC

Upload receipt. This may create or update Monarch data.

Inputs: file_path (required), fields, filename, output_mode, +2 more.

recurring_create_recurring_streamRecurring Create Recurring StreamC

Create recurring stream. This may create or update Monarch data.

Inputs: amount (required), base_date (required), frequency (required), merchant_id (required), +4 more.

recurring_get_recurring_streamRecurring Get Recurring StreamC
Read-onlyIdempotent

Get recurring stream.

Inputs: recurring_id (required), fields, output_mode, session_path, +1 more.

recurring_get_recurring_summaryRecurring Get Recurring SummaryD
Read-onlyIdempotent

Get recurring summary.

Inputs: end_date (required), start_date (required), fields, filters, +2 more.

recurring_list_recurring_occurrencesRecurring List Recurring OccurrencesD
Read-onlyIdempotent

List recurring occurrences.

Inputs: end_date (required), start_date (required), fields, filters, +3 more.

recurring_list_recurring_streamsRecurring List Recurring StreamsC
Read-onlyIdempotent

List recurring streams.

Inputs: fields, filters, output_mode, session_path, +2 more.

recurring_remove_recurring_streamRecurring Remove Recurring StreamC
Destructive

Remove recurring stream. This may delete, clear, reset, or otherwise remove data.

Inputs: recurring_id (required), fields, output_mode, session_path.

recurring_update_recurring_streamRecurring Update Recurring StreamC

Update recurring stream. This may create or update Monarch data.

Inputs: recurring_id (required), amount, fields, base_date, +4 more.

reports_create_saved_reportReports Create Saved ReportC

Create saved report. This may create or update Monarch data.

Inputs: name (required), fields, filters, group_by, +3 more.

reports_delete_saved_reportReports Delete Saved ReportC
Destructive

Delete saved report. This may delete, clear, reset, or otherwise remove data.

Inputs: report_id (required), fields, output_mode, session_path.

reports_get_report_dataReports Get Report DataD
Read-onlyIdempotent

Get report data.

Inputs: fields, filters, sort_by, group_by, +4 more.

reports_get_saved_reportReports Get Saved ReportC
Read-onlyIdempotent

Get saved report.

Inputs: report_id (required), fields, output_mode, session_path.

reports_list_saved_reportsReports List Saved ReportsC
Read-onlyIdempotent

List saved reports.

Inputs: fields, output_mode, session_path.

reports_update_saved_reportReports Update Saved ReportC

Update saved report. This may create or update Monarch data.

Inputs: name (required), report_id (required), fields, output_mode, +1 more.

tags_create_tagTags Create TagC

Create tag. This may create or update Monarch data.

Inputs: name (required), color (required), fields, output_mode, +1 more.

tags_delete_tagTags Delete TagC
Destructive

Delete tag. This may delete, clear, reset, or otherwise remove data.

Inputs: tag_id (required), fields, output_mode, session_path.

tags_get_tagTags Get TagC
Read-onlyIdempotent

Get tag.

Inputs: tag_id (required), fields, output_mode, session_path.

tags_list_tagsTags List TagsC
Read-onlyIdempotent

List tags.

Inputs: limit, fields, search, output_mode, +2 more.

tags_reorder_tagTags Reorder TagC

Reorder tag. This may create or update Monarch data.

Inputs: order (required), tag_id (required), fields, output_mode, +1 more.

tags_update_tagTags Update TagC

Update tag. This may create or update Monarch data.

Inputs: tag_id (required), name, color, fields, +2 more.

transactions_create_transactionTransactions Create TransactionC

Create transaction. This may create or update Monarch data.

Inputs: date (required), amount (required), account_id (required), category_id (required), +8 more.

transactions_delete_transactionTransactions Delete TransactionC
Destructive

Delete transaction. This may delete, clear, reset, or otherwise remove data.

Inputs: transaction_id (required), fields, output_mode, session_path.

transactions_delete_transaction_attachmentTransactions Delete Transaction AttachmentB
Destructive

Delete transaction attachment. This may delete, clear, reset, or otherwise remove data.

Inputs: attachment_id (required), fields, output_mode, session_path.

transactions_download_transaction_attachmentTransactions Download Transaction AttachmentC
Read-onlyIdempotent

Download transaction attachment.

Inputs: attachment_id (required), path, fields, output_mode, +1 more.

transactions_get_transactionTransactions Get TransactionC
Read-onlyIdempotent

Get transaction.

Inputs: transaction_id (required), fields, output_mode, session_path, +1 more.

transactions_get_transaction_attachmentTransactions Get Transaction AttachmentC
Read-onlyIdempotent

Get transaction attachment.

Inputs: attachment_id (required), fields, output_mode, session_path.

transactions_get_transaction_splitsTransactions Get Transaction SplitsC
Read-onlyIdempotent

Get transaction splits.

Inputs: transaction_id (required), fields, output_mode, session_path.

transactions_list_transaction_attachmentsTransactions List Transaction AttachmentsC
Read-onlyIdempotent

List transaction attachments.

Inputs: transaction_id (required), fields, output_mode, session_path, +1 more.

transactions_list_transactionsTransactions List TransactionsD
Read-onlyIdempotent

List transactions.

Inputs: sort, limit, fields, offset, +3 more.

transactions_unsplit_transactionTransactions Unsplit TransactionD

Unsplit transaction. This may create or update Monarch data.

Inputs: transaction_id (required), fields, output_mode, session_path.

transactions_update_transactionTransactions Update TransactionC

Update transaction. This may create or update Monarch data.

Inputs: transaction_id (required), date, notes, amount, +13 more.

transactions_update_transaction_splitsTransactions Update Transaction SplitsC

Update transaction splits. This may create or update Monarch data.

Inputs: splits (required), transaction_id (required), fields, output_mode, +1 more.

transactions_upload_transaction_attachmentTransactions Upload Transaction AttachmentB

Upload transaction attachment. This may create or update Monarch data.

Inputs: file_path (required), transaction_id (required), fields, filename, +3 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    C2.5/5.0

    Scored across 125 tools

    Disambiguation5/5

    Every tool is namespaced by a clear resource prefix such as transactions_, budget_, goals_, or receipts_, and each pairs it with a specific verb/object. Overlapping domains are rare, and even within large domains each tool addresses a distinct action such as contribute vs. withdraw or match vs. unmatch.

    Naming Consistency5/5

    The server uniformly follows a snake_case {domain}_{verb}_{object} naming pattern. List/get/create/update/delete are applied consistently across resources, with only intentional variations like reorder, archive, reactivate, or match that still fit the same convention.

    Tool Count1/5

    With 125 tools, this is an extreme mismatch for MCP server scope. Even though the financial domain is broad, the enormous surface forces agents to scan a massive tool list and significantly raises the risk of mis-selection.

    Completeness5/5

    The tool surface covers the Monarch Money domain comprehensively, including accounts, transactions with splits and attachments, receipts, budget, goals, investments, recurring streams, reports, categories, tags, merchants, cashflow, and household data. Each major area has read/create/update/delete or equivalent lifecycle operations, so obvious dead ends are hard to find.

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Resources

    Related MCP Connectors

    Related MCP Servers

    • Monarch Money MCP Server

      colvint
      F
      license
      Not graded
      quality
      D
      maintenance
      An MCP server that provides access to personal financial data from Monarch Money, allowing users to retrieve account information, transactions, budgets, goals, and net worth through natural language queries.
      16
      -

    • monarch-mcp

      bkichler
      F
      license
      B
      quality
      D
      maintenance
      MCP server that bridges Claude to Monarch Money for personal-finance analysis and lightweight edits.
      18
      -

    • Monarch Money MCP Server

      randallt21
      F
      license
      Not graded
      quality
      D
      maintenance
      An MCP server that integrates with Monarch Money to provide financial data access and operations, including account management, transaction filtering, budget analysis, and goal tracking through natural language.
      -