monzo-mcp

Monzo 뱅킹 API를 위한 MCP 서버입니다. Claude Code나 모든 MCP 클라이언트를 통해 계좌, 잔액, 팟, 거래 내역 및 지출 분석에 대한 읽기 전용 액세스를 제공합니다.

(6시간 후 만료되는) 원시 베어러 토큰을 사용하는 다른 Monzo MCP 구현과 달리, 이 서버는 자동 토큰 갱신을 포함한 전체 OAuth를 처리합니다.

주요 기능

• 7개의 읽기 전용 도구 - 쓰기 작업이나 자금 이동 없음

• 자동 갱신 OAuth - 토큰이 자동으로 갱신되므로 수동 재생성 불필요

• 로컬 거래 캐시 - Monzo의 90일 SCA 제한을 넘어서는 SQLite 데이터베이스 유지

• 지출 분석 - 카테고리별 분류, 주요 가맹점, 전월 대비 비교

• 거래 검색 - 캐시된 기록 전체에서 가맹점, 설명 또는 메모로 검색

Related MCP server: monzo-mcp

도구

사전 요구 사항

• Python 3.13+

• uv (권장) 또는 pip

• developers.monzo.com에 OAuth 클라이언트가 등록된 Monzo 계정

설치

git clone https://github.com/partymola/monzo-mcp.git
cd monzo-mcp
uv venv --python 3.13 .venv
uv pip install -e .

설정

1. Monzo OAuth 클라이언트 등록

developers.monzo.com에 접속하여 OAuth 클라이언트를 생성하세요:

• 리디렉션 URL을 http://localhost:6600/callback으로 설정

• Client ID와 Client Secret을 기록해 두세요

2. 인증

monzo-mcp auth

이 명령은 Monzo OAuth를 위해 브라우저를 엽니다. 인증 후 5분 이내에 Monzo 앱에서 로그인을 승인하면 전체 거래 내역(Monzo의 SCA 윈도우)에 액세스할 수 있습니다.

3. Claude Code에 등록

claude mcp add -s user monzo -- /path/to/monzo-mcp/.venv/bin/monzo-mcp

4. 첫 동기화

Claude Code에서 monzo_sync를 실행하여 로컬 거래 캐시를 채우세요. SCA 윈도우(최대 11개월 기록)를 활용하려면 인증 직후에 수행하는 것이 좋습니다.

구성

모든 구성은 환경 변수를 통해 이루어집니다 (선택 사항):

자격 증명 파일 (monzo-mcp auth로 생성됨):

• config/monzo_client.json - OAuth 클라이언트 ID 및 시크릿

• config/monzo_tokens.json - 액세스 및 갱신 토큰 (자동 갱신됨)

Monzo SCA 윈도우

Monzo의 강력한 고객 인증(SCA)은 거래 내역 액세스를 제한합니다:

• 앱 승인 후 5분 이내: 최대 약 11개월의 기록

• 윈도우 만료 후: 최근 90일 기록만 가능

로컬 SQLite 캐시는 동기화된 모든 거래를 영구적으로 보존하므로, monzo-mcp auth 직후에 monzo_sync를 실행하세요.

보안

• 쓰기 도구 없음 - 송금, 팟 간 자금 이동, 거래 수정 불가

• Monzo API 자체가 외부 계좌로 송금할 수 없음

• 토큰은 config/ 디렉토리에 JSON 파일로 저장됨 (gitignored)

• 모든 API 호출은 Bearer 토큰 인증을 사용하는 GET 요청임

기여

개발 환경 설정, 테스트 워크플로우 및 pre-commit 훅은 CONTRIBUTING.md를 참조하세요. 변경 사항은 CHANGELOG.md에서 추적됩니다.

라이선스

GPL-3.0-or-later. LICENSE를 참조하세요.