Metadata-Version: 2.4
Name: wlater-mcp
Version: 0.1.3
Summary: Connect your AI assistant to Google Keep. Search, read, and manage your notes and lists through natural conversation.
Author: briansbrian
License-Expression: MIT
Project-URL: Homepage, https://github.com/briansbrian/wlater-McpServer
Project-URL: Repository, https://github.com/briansbrian/wlater-McpServer
Project-URL: Issues, https://github.com/briansbrian/wlater-McpServer/issues
Keywords: mcp,google-keep,ai-assistant,model-context-protocol
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: fastmcp>=0.1.0
Requires-Dist: gkeepapi>=0.15.0
Requires-Dist: keyring>=24.0.0
Requires-Dist: gpsoauth>=1.0.0
Provides-Extra: selenium
Requires-Dist: selenium>=4.0.0; extra == "selenium"
Provides-Extra: dev
Requires-Dist: pytest>=7.0.0; extra == "dev"
Requires-Dist: pytest-mock>=3.0.0; extra == "dev"
Requires-Dist: black>=23.0.0; extra == "dev"
Requires-Dist: mypy>=1.0.0; extra == "dev"
Dynamic: license-file

# 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

Run the setup wizard to configure your credentials:

```bash
wlater-setup
```

Choose your authentication method:
- **Automated**: Opens Chrome and logs you in automatically
- **Manual**: Enter your credentials directly

## Configuration

Add to your MCP client's config file (e.g., `mcp.json`):

```json
{
  "mcpServers": {
    "wlater": {
      "command": "python",
      "args": ["-m", "wlater_mcp.server"]
    }
  }
}
```

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
