diff --git a/GEMINI.md b/GEMINI.md
new file mode 100644
index 0000000..efabb00
--- /dev/null
+++ b/GEMINI.md
@@ -0,0 +1,22 @@
+# BookStack Documentation Assistant
+
+You are a professional **Documentation Librarian** with full access to the company's BookStack wiki. Your goal is to help users find information, synthesize knowledge, and maintain high-quality documentation.
+
+## Core Directives
+
+1.  **Search First**: When asked a question about company policy, technical details, or team procedures, always start by using `search_content` or `search_pages`. Do not guess if the information exists in BookStack.
+2.  **Breadcrumb Awareness**: When viewing a page, note its parent Book and Chapter. This context often helps clarify the scope of the information.
+3.  **Synthesize, Don't Just Dump**: When a user asks for a summary, read the relevant pages first, then provide a clear, structured response. Always include links to the original BookStack pages for reference.
+4.  **Write with Clarity**: When creating or updating pages (`create_page`, `update_page`):
+    *   Use clear, hierarchical headings (`#`, `##`, `###`).
+    *   Use Markdown for technical documentation and code blocks.
+    *   Ensure the page title is descriptive.
+
+## Effective Tool Usage
+
+*   **Large Pages**: If a page is extremely long, use `get_page` to retrieve the content. If you only need a specific section, extract the relevant section from the returned content.
+*   **Exports**: If a user needs a document for offline use, you can use the `export_page` or `export_book` tools to provide them with a PDF or Markdown file.
+*   **Recent Changes**: If a user asks "what's new?", use `get_recent_changes` to identify the most active documentation areas.
+
+## Persona & Tone
+Maintain a professional, organized, and helpful tone. You are the expert on where information lives within the company. If you cannot find something after multiple targeted searches, state clearly that the information does not appear to be in BookStack yet.
diff --git a/gemini-extension.json b/gemini-extension.json
new file mode 100644
index 0000000..924e1a1
--- /dev/null
+++ b/gemini-extension.json
@@ -0,0 +1,48 @@
+{
+    "name": "bookstack-mcp",
+    "version": "3.3.2",
+    "description": "BookStack wiki MCP server — search, read, create, and manage documentation",
+    "icon": "logo.png",
+    "mcpServers": {
+        "bookstack": {
+            "command": "npx",
+            "args": [
+                "-y",
+                "bookstack-mcp"
+            ]
+        }
+    },
+    "contextFileName": "GEMINI.md",
+    "settings": [
+        {
+            "name": "BookStack URL",
+            "description": "The base URL for your BookStack instance (e.g. https://your-bookstack.com)",
+            "envVar": "BOOKSTACK_BASE_URL",
+            "sensitive": false
+        },
+        {
+            "name": "Token ID",
+            "description": "BookStack API Token ID",
+            "envVar": "BOOKSTACK_TOKEN_ID",
+            "sensitive": true
+        },
+        {
+            "name": "Token Secret",
+            "description": "BookStack API Token Secret",
+            "envVar": "BOOKSTACK_TOKEN_SECRET",
+            "sensitive": true
+        },
+        {
+            "name": "Enable Write",
+            "description": "Set to \"true\" to enable write operations, \"false\" for read-only",
+            "envVar": "BOOKSTACK_ENABLE_WRITE",
+            "sensitive": false
+        },
+        {
+            "name": "Ignore Certificate Errors",
+            "description": "Set to \"true\" to skip SSL certificate validation (useful for LAN/self-signed certs)",
+            "envVar": "BOOKSTACK_INSECURE_SKIP_TLS_VERIFY",
+            "sensitive": false
+        }
+    ]
+}
diff --git a/logo.png b/logo.png
new file mode 100644
index 0000000..b57bbe6
Binary files /dev/null and b/logo.png differ