wlater-mcp 0.2.0
Connect your AI assistant to Google Keep. Search, read, and manage your notes and lists through natural conversation.
Requires Python: >=3.8
Keywords: mcp, google-keep, ai-assistant, model-context-protocol

# wlater MCP Server

Connect your AI assistant to Google Keep. Search, read, and manage your notes and lists through natural conversation.

## Installation

```bash
pip install wlater-mcp
```

## Setup

### Quick Setup (Automated)

For automated authentication with Selenium:

```bash
pip install selenium
wlater-setup token
```

A browser window will open—just log in to your Google account and the token will be extracted automatically.

### Manual Setup

If you prefer manual setup or automated doesn't work:

```bash
wlater-setup
```

You'll need your master token. Get it from:
- [gpsoauth Guide](https://github.com/rukins/gpsoauth-java/blob/b74ebca999d0f5bd38a2eafe3c0d50be552f6385/README.md#receiving-an-authentication-token)
- [gkeepapi Documentation](https://gkeepapi.readthedocs.io/en/latest/#authenticating)

## Configuration

Add to your MCP client's config file:

**For VS Code** (`.vscode/mcp.json`):
```json
{
  "servers": {
    "wlater": {
      "command": "python",
      "args": ["-m", "wlater_mcp.server"]
    }
  }
}
```

**For Claude Desktop** or other MCP clients:
```json
{
  "mcpServers": {
    "wlater": {
      "command": "python",
      "args": ["-m", "wlater_mcp.server"],
      "disabled": false
    }
  }
}
```

Restart your AI assistant and you're ready!

## Usage

Talk to your AI naturally:

- "Show me all my pinned notes"
- "What's on my shopping list?"
- "Find notes with images attached"
- "Check off 'buy milk' from my grocery list"
- "Create a note called 'Meeting Notes'"
- "Add 'call dentist' to my todo list"
- "Find notes labeled 'work'"
- "Make my important note red and pin it"
- "Sort my shopping list alphabetically"

All changes are previewed before being saved to Google Keep.

## Features

**What You Can Do:**
- ✅ Search and read all your notes
- ✅ Filter by labels, colors, pins, and archived status
- ✅ View attached images, drawings, and audio
- ✅ Create new notes and todo lists
- ✅ Check off items on your shopping lists
- ✅ Update note content, titles, and colors
- ✅ Pin important notes and archive old ones
- ✅ Organize with labels
- ✅ Sort your lists alphabetically
- ✅ Share notes with collaborators

**How It Keeps You Safe:**
- 🔒 Your login credentials are stored securely in your system keyring
- 👀 Preview every change before it's saved
- 🚫 Can't delete notes ,Only Trash\Untrash (use Google Keep app for that)
- ⏸️ All changes wait for your approval—nothing happens automatically

## Troubleshooting

**"Master token not found"**
```bash
wlater-setup
```

**"Authentication failed"**  
Your token may have expired. Re-run setup.

**Server not appearing**  
Check your config file paths and restart your MCP client.

## Security

- Credentials stored in your system keyring (Windows Credential Locker, macOS Keychain, Linux Secret Service)
- Preview all changes before syncing
- No automatic modifications
- Delete operations not exposed

## Links

- [GitHub Repository](https://github.com/briansbrian/wlater-McpServer)
- [Report Issues](https://github.com/briansbrian/wlater-McpServer/issues)
- [Model Context Protocol](https://modelcontextprotocol.io)

## License

MIT License - See [LICENSE](LICENSE) for details