Monarch Money TypeScript SDK

Name: Monarch Money TypeScript SDK
Author: martinamps

@martinamps

Repository

About Monarch Money TypeScript SDK

small mcp server for accessing monarch money

#monarch-mcp #typescript-sdk #financial-data

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "monarch-mcp": {
      "command": "bun",
      "args": [
        "run",
        "example"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Monarch Money TypeScript SDK?

The Monarch Money TypeScript SDK is a library and MCP (Model Context Protocol) server that provides read-only access to Monarch Money financial data. It allows developers and AI agents to query accounts, transactions, budgets, cashflow, and more using TypeScript or through an MCP server compatible with AI assistants like Claude Desktop.

How to use Monarch Money TypeScript SDK?

Install with bun add monarchmoney or npm install monarchmoney. Authenticate using a browser token (from Monarch Money web) or email/password (optionally with MFA). Start the included MCP server via bun run mcp, or use the SDK directly in TypeScript code with methods like getAccounts().

Key features of Monarch Money TypeScript SDK

Read-only access to Monarch Money data
MCP server for AI agent integrations
Supports browser token, credentials, or saved session authentication
Handles multi-factor authentication (MFA)
Provides tools for accounts, transactions, budgets, and cashflow

Use cases of Monarch Money TypeScript SDK

Building custom financial dashboards or automation scripts
Enabling AI assistants to query personal finance data
Analyzing budgets and cashflow over time
Extracting transaction and account holdings for reporting

FAQ from Monarch Money TypeScript SDK

How do I get a browser token for authentication?

After logging into Monarch Money on the web, find the token in your browser's localStorage or Cookies (e.g., Chrome DevTools > Application > Storage > Local Storage > monarchmoney.com). Set it as environment variable MONARCH_TOKEN.

How do I handle multi-factor authentication (MFA)?

If login triggers a RequireMFAError, collect the MFA code from the user and call authenticateWithMFA() with email, password, and MFA code. The SDK supports this flow.

What data can I access with the SDK?

The SDK provides read-only methods for accounts, account holdings, account history, institutions, budgets, transactions, transaction categories, cashflow, recurring transactions, and subscription details.

Is the SDK read-only?

Yes, the README explicitly states it provides read-only access to Monarch Money data. No write operations are available.

How do I configure the MCP server for Claude Desktop?

Add a monarchMoney entry to your Claude Desktop configuration file (claude_desktop_config.json) with command bun, args ["run", "mcp"], env variable MONARCH_TOKEN, and the correct working directory path.