구글 킵을 위한 MCP 서버

기여 지침과 필요한 시각적 증거는 CONTRIBUTING.md 를 참조하세요.

사용 방법

1. MCP 서버를 MCP 서버에 추가하기:

또는 uvx와 함께:

2. 자격증 추가:

• GOOGLE_EMAIL: 구글 계정 이메일 주소
• GOOGLE_MASTER_TOKEN: 구글 계정 마스터 토큰

구글 마스터 토큰을 받으세요

keep-mcp는 gkeepapi를 사용하며, 이는 비공식 프라이빗 API를 통해 구글 킵과 연결됩니다. 구글 마스터 토큰은 당신의 계정에 완전한 접근 권한을 가집니다. 비밀번호처럼 취급하고 절대 커밋하거나 공유하지 마세요.

gpsoauth가 문서화한 브라우저 지원 토큰 교환을 사용하세요. 교환 운영 방식을 선택하세요:

• 로컬 파이썬: gpsoauth의 대체 흐름을 따라가세요.
• Docker: gkeepapi의 “마스터 토큰 획득” 지침을 따르세요. 이 방법은 로컬 Python 설치 없이 동일한 교환을 실행합니다.

두 옵션 모두 gpsoauth 문서에 설명된 브라우저 [oauth_token가 필요합니다.

이전 지침은 구글 비밀번호나 앱 비밀번호를 요구하고 perform_master_login()로 호출할 수 있습니다. 그 흐름은 신뢰할 수 없고 BadAuthentication로 반환될 수 있습니다. 대신 위의 브라우저 지원 흐름을 사용하세요.

특징

keep-mcp

MCP server for Google Keep

See CONTRIBUTING.md for contribution guidelines and required visual evidence.

How to use

1. Add the MCP server to your MCP servers:

  "mcpServers": {
    "keep-mcp-pipx": {
      "command": "pipx",
      "args": [
        "run",
        "keep-mcp"
      ],
      "env": {
        "GOOGLE_EMAIL": "Your Google Email",
        "GOOGLE_MASTER_TOKEN": "Your Google Master Token - see README.md"
      }
    }
  }

Or with uvx:

  "mcpServers": {
    "keep-mcp": {
      "command": "uvx",
      "args": [
        "keep-mcp"
      ],
      "env": {
        "GOOGLE_EMAIL": "Your Google Email",
        "GOOGLE_MASTER_TOKEN": "Your Google Master Token - see README.md"
      }
    }
  }

2. Add your credentials:

• GOOGLE_EMAIL: Your Google account email address
• GOOGLE_MASTER_TOKEN: Your Google account master token

Obtain a Google master token

keep-mcp uses gkeepapi, which connects to Google Keep through an unofficial private API. A Google master token has full access to your account. Treat it like a password and never commit or share it.

Use the browser-assisted token exchange documented by gpsoauth. Choose how you want to run the exchange:

• Local Python: Follow gpsoauth’s alternative flow.
• Docker: Follow gkeepapi’s “Obtaining a Master Token” instructions. This runs the same exchange without requiring a local Python installation.

Both options require the browser oauth_token described in the gpsoauth documentation.

Older instructions may ask for your Google password or an app password and call perform_master_login(). That flow is unreliable and can return BadAuthentication. Use the browser-assisted flow above instead.

Features

Query and read tools

• find: Search notes (case-insensitive by default) with optional filters for labels, colors, pinned, archived, trashed, creation/update date ranges (ISO 8601, UTC), and a result limit
• get_note: Get a single note by ID

Creation and update tools

• create_note: Create a new note with title and text (automatically adds keep-mcp label)
• create_list: Create a checklist note
• update_note: Update a note’s title and text
• add_list_item: Add an item to a checklist note
• update_list_item: Update checklist item text and checked state
• delete_list_item: Delete a checklist item

Note state tools

• set_note_color: Set a note color (valid values: DEFAULT, RED, ORANGE, YELLOW, GREEN, TEAL, BLUE, CERULEAN, PURPLE, PINK, BROWN, GRAY)
• pin_note: Pin or unpin a note
• archive_note: Archive or unarchive a note
• trash_note: Move a note to trash
• restore_note: Restore a trashed/deleted note