Metadata-Version: 2.4
Name: keep-agent-mem
Version: 1.1.1
Summary: Agent Memory via Google Keep MCP
Project-URL: Homepage, https://github.com/anand-92/keep-agent-mem
Project-URL: Repository, https://github.com/anand-92/keep-agent-mem
Author-email: Nik Anand <mntechsurvey@gmail.com>
License: MIT
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Topic :: Utilities
Requires-Python: >=3.10
Requires-Dist: fastmcp==3.4.2
Requires-Dist: gkeepapi>=0.16.0
Requires-Dist: python-dotenv>=1.2.2
Description-Content-Type: text/markdown

# keep-agent-mem

MCP server for Google Keep that serves as cross-device memory for your agents.


## How to use

1. Add the MCP server to your MCP servers:

```json
  "mcpServers": {
    "keep-agent-mem": {
      "command": "uvx",
      "args": [
        "keep-agent-mem"
      ],
      "env": {
        "GOOGLE_EMAIL": "Your Google Email",
        "GOOGLE_MASTER_TOKEN": "Your Google Master Token - see README.md"
      }
    }
  }
```

### `config.toml` clients (Codex, Goose, etc.)

```toml
[mcp_servers.keep_agent_mem]
command = "uvx"
args = ["keep-agent-mem"]

[mcp_servers.keep_agent_mem.env]
GOOGLE_EMAIL = "you@example.com"
GOOGLE_MASTER_TOKEN = "your-master-token"
```

2. Add your credentials:
* `GOOGLE_EMAIL`: Your Google account email address
* `GOOGLE_MASTER_TOKEN`: Your Google account master token

Check https://gkeepapi.readthedocs.io/en/latest/#obtaining-a-master-token and https://github.com/simon-weber/gpsoauth?tab=readme-ov-file#alternative-flow for more information.

## Tools

### Query and read tools
* `list_notes`: List all notes with optional filters for labels, colors, pinned, archived, and trashed

### Creation, update, and deletion tools
* `create`: Create a new note with a title, text, and an associated label
* `update`: Update a note's title and text
* `delete`: Delete a note by ID




## Troubleshooting

* If you get "DeviceManagementRequiredOrSyncDisabled" check https://admin.google.com/ac/devices/settings/general and turn "Turn off mobile management (Unmanaged)"
