Monarch Money MCP 서버

Claude Desktop을 통해 Monarch Money 개인 금융 플랫폼과 통합하기 위한 MCP(Model Context Protocol) 서버입니다.

개요

• 설계부터 안전함 — 브라우저 기반 로그인, OS 키체인에 토큰 저장 (설정 파일이나 환경 변수에 절대 저장되지 않음)

• 기본적으로 안전함 — 읽기 전용 모드가 실수로 인한 변경을 방지하며, 쓰기 도구는 명시적인 동의가 필요함

• 포괄적임 — 계좌, 거래, 분할, 예산, 현금 흐름, 태그, 카테고리, 신용 기록을 다루는 37개의 도구 제공

• 쉬운 설치 — Claude Desktop 확장 프로그램(.mcpb), uvx 또는 pip를 통해 설치 가능

두 가지 운영 모드:

서버는 기본적으로 읽기 전용 모드로 시작합니다. 쓰기 도구는 명시적으로 활성화하기 전까지 숨겨져 있고 차단됩니다.

Related MCP server: Monarch Money MCP Server

빠른 시작

설치

옵션 1: Claude Desktop 확장 프로그램 (.mcpb) — Claude Desktop 권장

Claude Desktop 앱에서 직접 쓰기 모드를 켜거나 끌 수 있습니다.

1. Releases에서 최신 .mcpb 파일을 다운로드합니다.

2. Claude Desktop에서: Settings > Extensions > Advanced Settings > Install Extensions로 이동하여 .mcpb 파일을 선택합니다.

3. Claude Desktop을 재시작합니다.

쓰기 도구를 활성화하려면: Settings > Extensions > Monarch Money MCP Server > Configure로 이동하여 **"Enable write tools"**를 토글하고 Save를 클릭합니다.

옵션 2: uvx (설치 불필요) — 에이전트(예: Claude Code 또는 Cursor) 권장

Claude Desktop에서도 작동하지만, 앱에서 쓰기 모드를 전환할 수 없으므로 설정 파일에서 직접 설정해야 합니다.

MCP 설정 파일에 추가하세요:

{
  "mcpServers": {
    "Monarch Money": {
      "command": "uvx",
      "args": ["monarch-mcp"]
    }
  }
}

쓰기 도구를 활성화하려면:

{
  "mcpServers": {
    "Monarch Money": {
      "command": "uvx",
      "args": ["monarch-mcp", "--enable-write"]
    }
  }
}

옵션 3: pip 설치 — 로컬 설치 및 venv 권장

pip install monarch-mcp

기여자: 릴리스 프로세스, 버전 체계 및 TestPyPI를 통한 사전 릴리스 테스트는 docs/releasing.md를 참조하세요.

Python 인터프리터의 전체 경로를 사용하여 MCP 설정에 추가하세요:

{
  "mcpServers": {
    "Monarch Money": {
      "command": "/path/to/bin/python3",
      "args": ["-m", "monarch_mcp"]
    }
  }
}

쓰기 도구를 활성화하려면 args에 "--enable-write"를 추가하세요.

옵션 4: 복제 및 설치 — 개발용 권장

git clone https://github.com/vargahis/monarch-mcp.git
cd monarch-mcp
pip install -e .

그런 다음 개발 환경의 Python 인터프리터를 사용하여 MCP 설정에 추가하세요:

{
  "mcpServers": {
    "Monarch Money": {
      "command": "/path/to/bin/python3",
      "args": ["-m", "monarch_mcp"]
    }
  }
}

쓰기 도구를 활성화하려면 args에 "--enable-write"를 추가하세요.

인증

인증은 저장된 세션 없이 MCP 서버가 처음 시작될 때 브라우저에서 자동으로 진행됩니다.

1. Claude Desktop을 시작(또는 재시작)합니다.

2. 서버가 토큰이 없음을 감지하고 브라우저에서 로그인 페이지를 엽니다.

3. Monarch Money 이메일과 비밀번호를 입력합니다.

4. MFA가 활성화된 경우 2FA 코드를 입력합니다.

5. 인증이 완료되면 토큰이 시스템 키링에 저장됩니다. 이제 준비가 완료되었습니다.

주요 세부 정보:

• 자격 증명은 브라우저에서만 입력 — Claude Desktop을 통해 입력하지 않음

• 토큰은 OS 키링에 저장 — 재시작 후에도 유지되며 수주/수개월간 지속됨

• 만료된 세션은 자동으로 재인증 — 다음 도구 호출 시 브라우저 로그인이 다시 트리거됨

• MFA 완벽 지원

• 대체 방법: 헤드리스 환경의 경우 터미널에서 python login_setup.py를 실행하세요.

인증 아키텍처에 대한 기술적 세부 정보는 docs/authentication.md를 참조하세요.

사용 예시

Show me all my financial accounts

What were my last 50 transactions?

How's my budget looking this month?

Analyze my cashflow for the last 3 months

Create a tag called "Business Expenses" in red

사용 가능한 도구

🙏 감사의 말

vargahis가 유지 관리하는 @robcerda의 monarch-mcp-server에서 포크되었습니다.

monarchmoneycommunity Python 라이브러리를 기반으로 구축되었습니다.

감사합니다:

• 원본 MCP 서버를 만든 @robcerda

• 원본 monarchmoney 라이브러리를 만든 @hammem

• 커뮤니티 포크를 만든 @bradleyseanf

라이선스

MIT 라이선스