🗒️ Google Keep MCP Server

Connect any AI assistant directly to your Google Keep — create, search, organize, export notes, set reminders, and more.

✨ What It Does

📦 Installation

pip install google-keep-notes-mcp

uv add google-keep-notes-mcp

Or run directly without installing (recommended for MCP clients):

uvx google-keep-notes-mcp

Requires Python 3.10+

🔐 Authentication

This package uses a master token obtained from your Google account session. It's a one-time setup.

⚠️ Use a dedicated/dummy Google account for safety.

First-Time Setup

Step 1 — Run the setup command:

google-keep-mcp setup

This will open accounts.google.com/EmbeddedSetup in your browser automatically and guide you step by step.

Step 2 — In the browser:

1. Sign in with your Google account
2. Click "I Agree"
3. Press F12 to open DevTools
4. Go to Application → Cookies → accounts.google.com
5. Find the oauth_token row → click it
6. At the bottom, triple-click the Cookie Value → Ctrl+C to copy

⚡ Do this quickly — the token expires fast. Have your terminal ready before copying.

Step 3 — Back in terminal:

Paste your email and the copied oauth_token value when prompted. Your master token is generated and saved automatically to:

~/.google_keep_mcp/config.env

You won't need to do this again unless your token expires.

⏰ Reminders Setup (Optional)

Reminders use the Google Tasks API. One-time setup required:

1. Go to console.cloud.google.com → Create a new project
2. Enable Google Tasks API
3. Go to OAuth Consent Screen → Add your Google account as a test user
4. Create OAuth 2.0 Credentials → Desktop App type → Download credentials.json
5. Place it at: ~/.google_keep_mcp/credentials.json

First time you set a reminder, a browser window opens to authorize. After that it's fully automatic.

🖥️ Client Setup

{
  "mcpServers": {
    "google-keep": {
      "command": "uvx",
      "args": ["google-keep-notes-mcp"]
    }
  }
}

{
  "mcpServers": {
    "google-keep": {
      "command": "uvx",
      "args": ["google-keep-notes-mcp"]
    }
  }
}

{
  "servers": {
    "google-keep": {
      "type": "stdio",
      "command": "uvx",
      "args": ["google-keep-notes-mcp"]
    }
  }
}

{
  "mcpServers": {
    "google-keep": {
      "command": "uvx",
      "args": ["google-keep-notes-mcp"]
    }
  }
}

🛠️ Tools Reference

Notes

Organization

Labels

Reminders & Collaboration

Export

Insights

Templates

Available templates: meeting · journal · project · shopping · ideas

💬 Example Prompts

Create a note titled "Weekend Plans" with a list of things to do

Search my notes for anything about Python

Set a reminder for my "Internship Application" note for tomorrow at 9am

Export my "MCP Concepts" note as a PDF

Auto-label all my notes

Give me a weekly digest of my Google Keep notes

Show me analytics about my notes

Create a meeting note for today's standup

Add collaborator friend@gmail.com to my "Project Plan" note

❌ Known Limitations

• Image attachment — Attaching images inside notes is not supported (Google's private upload endpoint is unavailable via this library)
• Native reminder bell — Keep's built-in reminder bell cannot be set via this method; reminders are created in Google Tasks instead (fully functional with notifications)

📄 License

MIT © Muhammad Abubakar