Metadata-Version: 2.4
Name: wlater-mcp
Version: 0.1.0
Summary: A Model Context Protocol (MCP) server that provides AI assistants with secure, read-only access to Google Keep notes and lists.
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., `claude_desktop_config.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?"
- "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'"

All changes are previewed before being saved to Google Keep.

## Features

- ✅ Read and search your Keep notes
- ✅ Manage todo lists (check/uncheck items)
- ✅ Create notes and lists
- ✅ Add labels and change colors
- ✅ Preview changes before syncing
- ✅ Secure credential storage (OS keyring)
- ❌ Cannot delete notes (safety feature)

## 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
