Metadata-Version: 2.4
Name: google-keep-notes-mcp
Version: 0.1.3
Summary: MCP server for Google Keep
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: gkeepapi>=0.17.1
Requires-Dist: google-api-python-client>=2.198.0
Requires-Dist: google-auth-oauthlib>=1.4.0
Requires-Dist: markdown>=3.10.2
Requires-Dist: mcp>=1.28.1
Requires-Dist: python-docx>=1.2.0
Requires-Dist: python-dotenv>=1.2.2
Requires-Dist: reportlab>=5.0.0
Dynamic: license-file

# Google Keep MCP

Google Keep MCP is a Model Context Protocol server for Google Keep.

PyPI package name: `google-keep-notes-mcp`

CLI command: `google-keep-mcp`

## What this project is

- Installable as a normal Python package
- Usable from Claude Desktop, Cursor, and any other MCP client
- Designed so each user logs in with their own Google Keep account
- Stores login state locally on each user machine

## Install

### With uv

```powershell
uv add google-keep-notes-mcp
```

### With pip

```powershell
pip install google-keep-notes-mcp
```

### From this repo for local testing

```powershell
cd D:\MyWorld\google-Keep-MCP
uv pip install -e .
```

## Run

After install, run the server command:

```powershell
google-keep-mcp
```

For local repo testing you can also run it through uv:

```powershell
uv run --directory D:\MyWorld\google-Keep-MCP google-keep-mcp
```

## First-time login

Each user must log in once on their own machine.

Run:

```powershell
google-keep-mcp login
```

Then enter:

- your Google email
- your Google Keep master token

The login is saved locally in:

- Windows: `C:\Users\<you>\.google_keep_mcp\config.json`
- macOS/Linux: `~/.google_keep_mcp/config.json`

If the token is revoked or removed, the user must log in again.

## Claude Desktop config

For local testing, point Claude Desktop to the installed command:

```json
{
  "mcpServers": {
    "google-keep": {
      "command": "D:\\MyWorld\\google-Keep-MCP\\.venv-test\\Scripts\\google-keep-mcp.exe"
    }
  }
}
```

If the package is installed globally or into the active environment, this also works:

```json
{
  "mcpServers": {
    "google-keep": {
      "command": "google-keep-mcp"
    }
  }
}
```

If you want Claude to run the package directly from PyPI without relying on PATH, use uvx:

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

## Google Tasks reminders

Reminder tools use Google Tasks OAuth credentials.

Place the credentials file here:

```text
C:\Users\<you>\.google_keep_mcp\credentials.json
```

The reminder token is cached here:

```text
C:\Users\<you>\.google_keep_mcp\token.json
```

## What new users need

- Install the package
- Run `google-keep-mcp login`
- Paste their own Google Keep master token
- Then use the MCP server from Claude or any other MCP client

## Public release note

This package is published on PyPI as `google-keep-notes-mcp`.

Users install it with `uv add google-keep-notes-mcp` or `pip install google-keep-notes-mcp`, then run `google-keep-mcp`.

## License

MIT
