8 files changed, 32 insertions, 1 deletions
diff --git a/README.md b/README.md
index 8ffb0fd..14f7c0c 100644
--- a/README.md
+++ b/README.md
@@ -107,6 +107,12 @@ To use any of the MCP servers in this repository, you can run them using `uv` fr
 
 ```bash
 # Example: Run GitLab glab server
+⚠️ **DEPRECATION NOTICE:** The `gitlab_glab` server is deprecated. Use `gitlab_python` instead:
+
+# Example: Run GitLab Python server (recommended)
+uv --directory /path-to-repo/dawids-mcp-servers/servers/gitlab_python run mcp-gitlab-python --transport stdio
+
+# (Legacy) Run GitLab glab server
 uv --directory /path-to-repo/dawids-mcp-servers/servers/gitlab_glab run mcp-gitlab-glab --transport stdio
 
 # Example: Run hello world server  
diff --git a/servers/gitlab_glab/Dockerfile b/servers/gitlab_glab/Dockerfile
index db86015..2ced0fa 100644
--- a/servers/gitlab_glab/Dockerfile
+++ b/servers/gitlab_glab/Dockerfile
@@ -1,3 +1,5 @@
+# ⚠️ DEPRECATION NOTICE: This Docker image is for the deprecated gitlab_glab MCP server. Use gitlab_python instead.
+
 # Multi-stage build for GitLab CLI MCP Server
 
 # Stage 1: Build stage
diff --git a/servers/gitlab_glab/README.md b/servers/gitlab_glab/README.md
index 1457cad..7a4bc5f 100644
--- a/servers/gitlab_glab/README.md
+++ b/servers/gitlab_glab/README.md
@@ -1,3 +1,4 @@
+<!-- ⚠️ DEPRECATION NOTICE: The `gitlab_glab` MCP server is deprecated and will no longer be maintained. Please migrate to the `gitlab_python` MCP server, which is the recommended and actively supported replacement. See `servers/gitlab_python/README.md` for details. -->
 # GitLab CLI MCP Server
 
 This MCP server provides integration with GitLab through the GitLab CLI (`glab`) tool. It allows LLM agents to interact with GitLab repositories and resources using the GitLab API.
diff --git a/servers/gitlab_glab/pyproject.toml b/servers/gitlab_glab/pyproject.toml
index deeb07c..3d1ce87 100644
--- a/servers/gitlab_glab/pyproject.toml
+++ b/servers/gitlab_glab/pyproject.toml
@@ -1,7 +1,7 @@
 [project]
 name = "mcp-server-gitlab-glab"
 version = "0.1.0"
-description = "An MCP server for GitLab CLI integration"
+description = "[DEPRECATED: Use mcp-server-gitlab-python instead] An MCP server for GitLab CLI integration"
 readme = "README.md"
 requires-python = ">=3.11"
 license = {text = "MIT"}
diff --git a/servers/gitlab_glab/src/mcp_server_gitlab_glab/__init__.py b/servers/gitlab_glab/src/mcp_server_gitlab_glab/__init__.py
index cd431bb..1791ddc 100644
--- a/servers/gitlab_glab/src/mcp_server_gitlab_glab/__init__.py
+++ b/servers/gitlab_glab/src/mcp_server_gitlab_glab/__init__.py
@@ -1,5 +1,7 @@
 """GitLab CLI MCP Server package.
 
+⚠️ DEPRECATION NOTICE: This package is deprecated. Please use the gitlab_python MCP server instead.
+
 This package provides an MCP server that integrates with GitLab through the GitLab CLI
 (glab).
 """
diff --git a/servers/gitlab_glab/src/mcp_server_gitlab_glab/__main__.py b/servers/gitlab_glab/src/mcp_server_gitlab_glab/__main__.py
index dedd9f8..e393b6c 100644
--- a/servers/gitlab_glab/src/mcp_server_gitlab_glab/__main__.py
+++ b/servers/gitlab_glab/src/mcp_server_gitlab_glab/__main__.py
@@ -1,6 +1,15 @@
 #!/usr/bin/env python3
 """Command-line interface for the GitLab CLI MCP server."""
 
+import sys
+
+print(
+    "\u26A0\uFE0F DEPRECATION NOTICE: The gitlab_glab MCP server is deprecated and will no longer be maintained. "
+    "Please migrate to the gitlab_python MCP server, which is the recommended and actively supported replacement. "
+    "See servers/gitlab_python/README.md for details.",
+    file=sys.stderr,
+)
+
 from .cli import run_server
 
 if __name__ == "__main__":
diff --git a/servers/gitlab_glab/src/mcp_server_gitlab_glab/cli.py b/servers/gitlab_glab/src/mcp_server_gitlab_glab/cli.py
index 69173f7..92abe0f 100644
--- a/servers/gitlab_glab/src/mcp_server_gitlab_glab/cli.py
+++ b/servers/gitlab_glab/src/mcp_server_gitlab_glab/cli.py
@@ -103,6 +103,12 @@ def setup_logging(level: str, transport: str) -> None:
 
 def run_server() -> None:
     """Run the server with CLI arguments."""
+    print(
+        "\u26A0\uFE0F DEPRECATION NOTICE: The gitlab_glab MCP server is deprecated and will no longer be maintained. "
+        "Please migrate to the gitlab_python MCP server, which is the recommended and actively supported replacement. "
+        "See servers/gitlab_python/README.md for details.",
+        file=sys.stderr,
+    )
     args = validate_args(parse_args())
     setup_logging(args.log_level, args.transport)
 
diff --git a/servers/gitlab_glab/src/mcp_server_gitlab_glab/server.py b/servers/gitlab_glab/src/mcp_server_gitlab_glab/server.py
index f239246..5517ba4 100644
--- a/servers/gitlab_glab/src/mcp_server_gitlab_glab/server.py
+++ b/servers/gitlab_glab/src/mcp_server_gitlab_glab/server.py
@@ -806,6 +806,11 @@ async def main(transport_type: str, host: str, port: int) -> None:
         host: The host to bind to for remote transport.
         port: The port to bind to for remote transport.
     """
+    logger.warning(
+        "DEPRECATION NOTICE: The gitlab_glab MCP server is deprecated and will no longer be maintained. "
+        "Please migrate to the gitlab_python MCP server, which is the recommended and actively supported replacement. "
+        "See servers/gitlab_python/README.md for details."
+    )
     logger.info("Starting MCP GitLab CLI Server")
     logger.info(f"Starting GitLab CLI MCP Server with {transport_type} transport")