keep-mcp 0.1.0__tar.gz

keep_mcp-0.1.0/.example.env

@@ -0,0 +1,3 @@
+# Google Keep API Credentials
+GOOGLE_EMAIL=your-email@gmail.com
+GOOGLE_MASTER_TOKEN=your-master-token-see-the-readme-on-how-to-get-it 

keep_mcp-0.1.0/.gitignore

@@ -0,0 +1,47 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Virtual Environment
+.venv/
+venv/
+ENV/
+
+# Environment variables
+.env
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+
+# IDE specific files
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# OS specific files
+.DS_Store
+Thumbs.db
+
+# Project specific
+.cursor/
+uv.lock

keep_mcp-0.1.0/.python-version

@@ -0,0 +1 @@
+3.10

keep_mcp-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Jannik Feuerhahn
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

keep_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,74 @@
+Metadata-Version: 2.4
+Name: keep-mcp
+Version: 0.1.0
+Summary: MCP Server for Google Keep
+Project-URL: Homepage, https://github.com/feuerdev/keep-mcp
+Project-URL: Repository, https://github.com/feuerdev/keep-mcp
+Author-email: Jannik Feuerhahn <jannik@feuer.dev>
+License: MIT License
+        
+        Copyright (c) 2025 Jannik Feuerhahn
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+License-File: LICENSE
+Classifier: Development Status :: 4 - Beta
+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: gkeepapi>=0.16.0
+Requires-Dist: mcp[cli]
+Description-Content-Type: text/markdown
+
+# keep-mcp
+
+MCP server for Google Keep
+
+## How to use
+
+1. Add the MCP server to your MCP servers:
+
+```json
+  "mcpServers": {
+    "keep-mcp-pipx": {
+      "command": "pipx",
+      "args": [
+        "run",
+        "keep-mcp"
+      ],
+      "env": {
+        "GOOGLE_EMAIL": "Your Google Email",
+        "GOOGLE_MASTER_TOKEN": "Your Google Master Token - see README.md"
+      }
+    }
+  }
+```
+
+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.
+
+## Troubleshooting
+
+* If you get "DeviceManagementRequiredOrSyncDisabled" check https://admin.google.com/ac/devices/settings/general and turn "Turn off mobile management (Unmanaged)"

keep_mcp-0.1.0/README.md

@@ -0,0 +1,33 @@
+# keep-mcp
+
+MCP server for Google Keep
+
+## How to use
+
+1. Add the MCP server to your MCP servers:
+
+```json
+  "mcpServers": {
+    "keep-mcp-pipx": {
+      "command": "pipx",
+      "args": [
+        "run",
+        "keep-mcp"
+      ],
+      "env": {
+        "GOOGLE_EMAIL": "Your Google Email",
+        "GOOGLE_MASTER_TOKEN": "Your Google Master Token - see README.md"
+      }
+    }
+  }
+```
+
+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.
+
+## Troubleshooting
+
+* If you get "DeviceManagementRequiredOrSyncDisabled" check https://admin.google.com/ac/devices/settings/general and turn "Turn off mobile management (Unmanaged)"

keep_mcp-0.1.0/bin/keep-mcp.js

@@ -0,0 +1,32 @@
+#!/usr/bin/env node
+
+const { spawn } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+
+// Get the directory where the package is installed
+const packageRoot = path.resolve(__dirname, '..');
+
+// Find the Python script
+const scriptPath = path.join(packageRoot, 'main.py');
+if (!fs.existsSync(scriptPath)) {
+    console.error('Could not find main.py');
+    process.exit(1);
+}
+
+// Run the Python script
+const pythonProcess = spawn('python', [scriptPath], {
+    stdio: 'inherit' // This automatically handles all stdio forwarding
+});
+
+// Handle process exit
+pythonProcess.on('exit', (code) => {
+    if (code !== 0) {
+        console.error(`Process exited with code ${code}`);
+    }
+    process.exit(code);
+});
+
+// Forward termination signals to the Python process
+process.on('SIGINT', () => pythonProcess.kill('SIGINT'));
+process.on('SIGTERM', () => pythonProcess.kill('SIGTERM')); 

keep_mcp-0.1.0/pyproject.toml

@@ -0,0 +1,37 @@
+[project]
+name = "keep-mcp"
+version = "0.1.0"
+description = "MCP Server for Google Keep"
+readme = "README.md"
+requires-python = ">=3.10"
+dependencies = [
+    "gkeepapi>=0.16.0",
+    "mcp[cli]",
+]
+authors = [
+    { name = "Jannik Feuerhahn", email = "jannik@feuer.dev" }
+]
+license = { file = "LICENSE" }
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: End Users/Desktop",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Topic :: Utilities",
+]
+
+[project.urls]
+Homepage = "https://github.com/feuerdev/keep-mcp"
+Repository = "https://github.com/feuerdev/keep-mcp"
+
+[project.scripts]
+mcp = "server.cli:main"
+
+[build-system]
+requires = ["hatchling >= 1.26"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/server"]

keep_mcp-0.1.0/src/server/__main__.py

@@ -0,0 +1,4 @@
+from .cli import main
+
+if __name__ == "__main__":
+    main()

keep_mcp-0.1.0/src/server/cli.py

@@ -0,0 +1,43 @@
+"""
+MCP plugin for Google Keep integration.
+Provides tools for interacting with Google Keep notes through MCP.
+"""
+
+from mcp.server.fastmcp import FastMCP
+from .keep_api import get_notes, create_note
+
+mcp = FastMCP("keep")
+
+@mcp.resource("greeting://{name}")
+def get_greeting(name: str) -> str:
+    """Get a personalized greeting"""
+    return f"Hello, {name}!"
+
+@mcp.resource("notes://all")
+def get_all_notes() -> str:
+    """Get all Google Keep notes as a resource"""
+    return get_notes()
+
+@mcp.tool()
+def create_keep_note(title: str, text: str, pinned: bool = False) -> str:
+    """
+    Create a new Google Keep note.
+    
+    Args:
+        title (str): The title of the note
+        text (str): The content of the note
+        pinned (bool, optional): Whether the note should be pinned. Defaults to False.
+        
+    Returns:
+        str: JSON string containing the created note's data
+    """
+    return create_note(title, text, pinned)
+
+
+def main():
+    mcp.run(transport='stdio')
+
+
+if __name__ == "__main__":
+    main()
+    

keep_mcp-0.1.0/src/server/keep_api.py

@@ -0,0 +1,79 @@
+import gkeepapi
+import json
+import sys
+import os
+from dotenv import load_dotenv
+
+def get_notes():
+    # Load environment variables
+    load_dotenv()
+    
+    # Get credentials from environment variables
+    email = os.getenv('GOOGLE_EMAIL')
+    master_token = os.getenv('GOOGLE_MASTER_TOKEN')
+    
+    if not email or not master_token:
+        raise ValueError("Missing credentials in environment variables")
+    
+    # Initialize the Keep API
+    keep = gkeepapi.Keep()
+    
+    # Authenticate
+    keep.authenticate(email, master_token)
+    
+    # Get all notes
+    notes = keep.all()
+    
+    # Convert notes to a serializable format
+    notes_data = []
+    for note in notes:
+        notes_data.append({
+            'id': note.id,
+            'title': note.title,
+            'text': note.text,
+            'pinned': note.pinned,
+            'archived': note.archived,
+            'color': note.color.value if note.color else None,
+            'labels': [label.name for label in note.labels.all()]
+        })
+    
+    # Return the JSON string
+    return json.dumps(notes_data)
+
+def create_note(title: str, text: str, pinned: bool = False) -> str:
+    # Load environment variables
+    load_dotenv()
+    
+    # Get credentials from environment variables
+    email = os.getenv('GOOGLE_EMAIL')
+    master_token = os.getenv('GOOGLE_MASTER_TOKEN')
+    
+    if not email or not master_token:
+        raise ValueError("Missing credentials in environment variables")
+    
+    # Initialize the Keep API
+    keep = gkeepapi.Keep()
+    
+    # Authenticate
+    keep.authenticate(email, master_token)
+    
+    # Create a new note
+    note = keep.createNote(title, text)
+    note.pinned = pinned
+    
+    # Sync changes
+    keep.sync()
+    
+    # Return the created note's data
+    return json.dumps({
+        'id': note.id,
+        'title': note.title,
+        'text': note.text,
+        'pinned': note.pinned,
+        'archived': note.archived,
+        'color': note.color.value if note.color else None,
+        'labels': [label.name for label in note.labels.all()]
+    })
+
+if __name__ == '__main__':
+    print(get_notes())