# google-keep-mcp

An [MCP](https://modelcontextprotocol.io) server that exposes Google Keep notes
as tools, so an MCP client (Claude Code, Claude Desktop, etc.) can work with
them.

> **Status:** scaffolding only — not implemented yet.

Google Keep has no official public API. This project talks to Keep through
[`gkeepapi`](https://github.com/kiwiz/gkeepapi), an unofficial client — expect
it to break whenever Google changes the private endpoints.

## Requirements

- Python 3.13+
- [uv](https://docs.astral.sh/uv/)

## Setup

```bash
uv sync
cp .env.example .env   # then fill in your credentials
```

### Credentials

`gkeepapi` authenticates with a Google **master token**, not your password.
Obtain one once (see the [gkeepapi docs](https://gkeepapi.readthedocs.io/en/latest/#logging-in)),
then set `GOOGLE_KEEP_EMAIL` and `GOOGLE_KEEP_MASTER_TOKEN` — see
[.env.example](.env.example).

A master token grants full access to the account. Treat it like a password:
keep it out of version control and out of shell history.

## Development

```bash
uv run ruff check .      # lint
uv run ruff format .     # format
uv run pytest            # tests
```

## License

MIT — see [LICENSE](LICENSE).