quicken-mac-mcp

Claude에게 Quicken For Mac 금융 데이터에 대한 읽기 전용 액세스 권한을 부여하는 Claude Skill + MCP 서버입니다. Claude에게 계정, 거래, 카테고리별 지출, 월별 추세, 투자 보유 자산 등에 대해 질문해 보세요.

데이터베이스는 항상 읽기 전용으로 열리므로 Quicken 데이터는 절대 수정되지 않습니다.

Skill인가 MCP인가 — 무엇을 선택해야 할까요?

이 저장소는 동일한 스키마 지식(docs/schema.md)을 공유하는 두 가지 아티팩트를 제공합니다:

• Skill (plugin/skills/quicken/SKILL.md) — Claude가 sqlite3 CLI를 사용하여 Quicken SQLite 데이터베이스를 직접 읽도록 가르칩니다. Claude Code 및 스킬을 로드하는 모든 Claude 인터페이스에서 작동합니다. 네이티브 모듈 설치나 MCP 서버 프로세스가 필요 없으며, SQL만 사용합니다. 이 방식을 권장합니다.

• MCP 서버 — 8개의 사전 패키지된 도구(list_accounts, query_transactions, spending_by_category 등)로 동일한 SQL 레시피를 래핑합니다. 스킬을 로드할 수 없는 비 Claude MCP 클라이언트(Cursor, Cline, mcp-remote 브리지)에서 작업하거나, Claude가 SQL을 작성하게 하는 대신 유형이 지정된 도구를 호출하려는 경우에 사용하세요.

Claude Code 플러그인 설치(claude plugin install quicken-mac-mcp)는 둘 다 번들로 제공하며, 스킬이 우선적으로 사용되고 MCP 도구는 바로가기로 사용할 수 있습니다.

Related MCP server: banktivity-mcp

요구 사항

스킬이나 MCP를 사용하는 동안 Quicken For Mac이 열려 있어야 합니다. Quicken은 앱이 닫혀 있을 때 데이터베이스 파일을 암호화하므로, 데이터는 Quicken이 실행 중일 때만 읽을 수 있습니다.

작동 방식

Quicken For Mac은 Documents 폴더 내의 .quicken 번들(예: ~/Documents/MyFinances.quicken/data) 안에 있는 Core Data SQLite 데이터베이스에 데이터를 저장합니다. 스킬은 Claude에게 해당 데이터베이스를 직접 쿼리하는 방법을 가르치며, MCP 서버는 8개의 사전 패키지된 쿼리를 도구로 노출하는 얇은 래퍼입니다.

설치 — 권장 사항 (Claude Code, 플러그인)

claude plugin install quicken-mac-mcp

이 명령은 /quicken 스킬(권장 경로)과 MCP 서버를 모두 설치합니다. Claude는 스킬을 우선적으로 사용하고 필요할 때 MCP 도구로 대체합니다.

설치 — MCP 전용 경로

스킬을 로드할 수 없는 비 Claude Code 클라이언트를 사용 중이거나, 유형이 지정된 도구 래퍼만 원하는 경우 이 경로를 사용하세요.

Claude Code (MCP 전용)

claude mcp add quicken -- npx -y quicken-mac-mcp

Claude Desktop (MCPB 드래그 앤 드롭)

최신 GitHub 릴리스에서 quicken-mac-mcp.mcpb를 다운로드하여 Claude Desktop으로 드래그하세요. 데이터베이스 경로를 묻는 메시지가 표시되거나 자동으로 감지됩니다.

Claude Desktop (수동 JSON)

~/Library/Application Support/Claude/claude_desktop_config.json에 다음을 추가하세요:

{
  "mcpServers": {
    "quicken": {
      "command": "npx",
      "args": ["-y", "quicken-mac-mcp"]
    }
  }
}

Claude Desktop을 다시 시작하면 8개의 도구를 사용할 수 있는 망치 아이콘이 표시됩니다.

사용자 지정 데이터베이스 경로

여러 개의 Quicken 파일이 있거나 .quicken 번들이 ~/Documents에 없는 경우 QUICKEN_DB_PATH 환경 변수를 설정하세요:

{
  "mcpServers": {
    "quicken": {
      "command": "npx",
      "args": ["-y", "quicken-mac-mcp"],
      "env": {
        "QUICKEN_DB_PATH": "/path/to/YourFile.quicken/data"
      }
    }
  }
}

기본적으로 서버는 ~/Documents에서 가장 최근에 수정된 .quicken 번들을 선택하여 Quicken 데이터베이스를 자동으로 감지합니다.

MCP 도구

MCP 서버가 노출하는 8개의 사전 패키지된 도구입니다. 스킬은 데이터베이스에 대해 직접 SQL을 작성하여 동일한 범위(그 이상)를 다룹니다. plugin/skills/quicken/SKILL.md를 참조하세요.

예시 프롬프트

• "내 계정 목록을 보여줘"

• "지난달 식료품에 얼마를 썼지?"

• "2024년 카테고리별 지출을 보여줘"

• "지난 1년 동안 내 월별 지출이 어떻게 변했지?"

• "Costco에서 100달러 이상 결제한 모든 거래를 찾아줘"

• "거래 횟수 기준 상위 10명의 수취인은 누구지?"

• "2024년과 2025년의 식비 지출을 비교해줘"

데이터베이스 스키마

Quicken For Mac은 다음 주요 테이블과 함께 Core Data를 사용합니다:

날짜는 Core Data 에포크(2001-01-01 이후 초)를 사용합니다. MCP 서버는 모든 날짜 변환을 자동으로 처리합니다. ISO 8601 날짜를 전달하면 ISO 8601 날짜를 반환합니다. 스킬 레시피는 Claude가 직접 SQL을 작성할 수 있도록 변환(+ 978307200)을 인라인으로 보여줍니다.

계정 유형은 대문자 문자열로 저장됩니다: CHECKING, CREDITCARD, SAVINGS, MORTGAGE, RETIREMENTIRA, ASSET, LIABILITY, LOAN 등. 도구는 모든 대소문자를 허용합니다.

전체 스키마 참조(84개 엔티티, 모든 테이블, 인덱스, 외래 키 및 Z_OPT 낙관적 잠금을 포함한 Core Data 쓰기 의미론)는 docs/schema.md를 참조하세요.

개발

git clone https://github.com/dweekly/quicken-mac-mcp.git
cd quicken-mac-mcp
npm install
npm test          # run tests
npm run lint      # eslint
npm run format    # prettier
npm run dev       # run server locally

Docker

docker build -t quicken-mac-mcp .
docker run --rm -v ~/Documents/YourFile.quicken:/data:ro quicken-mac-mcp

기여자

• Manish Mukherjee — CategoryTag에 대한 동적 Z_ENT 조회 수정(#4), account_names 필터 및 가져온 거래에 대한 날짜 대체 기능 추가(#5)

• Als-Pal — Quicken ↔ Amazon 주문 매처 gist를 통해 메모가 두 수준(ZTRANSACTION.ZNOTE 및 ZCASHFLOWTRANSACTIONENTRY.ZNOTE)에 존재함을 밝히고, 현재 docs/schema.md에 있는 Z_OPT 쓰기 백 의미론을 문서화함.

면책 조항

이 프로젝트는 독립적인 커뮤니티 개발 오픈 소스 도구입니다. 공식 Intuit 제품이 아니며 Intuit Inc. 또는 그 자회사와 직접적인 관련이 있거나, 보증, 유지 관리 또는 후원을 받지 않습니다. "Quicken"은 Intuit Inc.의 등록 상표입니다. 모든 제품 및 회사 이름은 해당 소유자의 상표 또는 등록 상표입니다. 이를 사용한다고 해서 해당 업체와의 제휴나 보증을 의미하지는 않습니다.

이 소프트웨어는 어떠한 종류의 보증 없이 "있는 그대로" 제공됩니다. 저자와 기여자는 이 소프트웨어의 사용으로 인해 발생하는 손상, 데이터 손실 또는 기타 문제에 대해 책임을 지지 않습니다. 타사 도구를 사용하기 전에 항상 금융 데이터를 백업하십시오.

라이선스

MIT