@nimbus-app/mcp 1.0.0 → 1.0.2

package/README.md

@@ -1,25 +1,25 @@
 # Nimbus MCP Server
 
-Connect Claude to your task memory. This MCP server lets Claude access your captured tasks and platform knowledge from Nimbus, so it can learn how you perform tasks and help you more effectively.
+Connect your AI assistant to your workflow memory. This MCP server lets AI tools access your captured tasks and platform knowledge from Nimbus, so they can learn how you perform tasks and help you more effectively.
 
 ## Quick Start
 
-### 1. Install
-
-```bash
-npm install -g @nimbus-app/mcp
-```
-
-### 2. Get Your API Key
+### 1. Get Your API Key
 
 1. Open the Nimbus desktop app
 2. Go to **Settings** → **Account**
 3. Click **Generate MCP API Key**
 4. Copy the key (starts with `nimbus_`)
 
-### 3. Configure Claude Desktop
+### 2. Connect Your AI Tool
+
+Choose your platform below.
+
+---
 
-Add to your Claude Desktop config file:
+## Claude Desktop
+
+Add to your config file:
 
 **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
 **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
@@ -28,22 +28,155 @@ Add to your Claude Desktop config file:
 {
   "mcpServers": {
     "nimbus": {
-      "command": "nimbus-mcp",
+      "command": "npx",
+      "args": ["-y", "@nimbus-app/mcp"],
       "env": {
-        "NIMBUS_API_KEY": "nimbus_your_api_key_here"
+        "NIMBUS_API_KEY": "nimbus_your_key_here"
       }
     }
   }
 }
 ```
 
-### 4. Restart Claude Desktop
+Restart Claude Desktop (Cmd+Q / Ctrl+Q, reopen). You should see "nimbus" in the MCP tools list.
+
+---
+
+## Claude Code (CLI)
+
+One command:
+
+```bash
+claude mcp add nimbus -e NIMBUS_API_KEY=your_key -- npx -y @nimbus-app/mcp
+```
+
+To make it available across all projects:
+
+```bash
+claude mcp add --scope user nimbus -e NIMBUS_API_KEY=your_key -- npx -y @nimbus-app/mcp
+```
+
+---
+
+## Cursor
+
+Add to your MCP config:
+
+**Global:** `~/.cursor/mcp.json`
+**Per-project:** `.cursor/mcp.json` in project root
+
+```json
+{
+  "mcpServers": {
+    "nimbus": {
+      "command": "npx",
+      "args": ["-y", "@nimbus-app/mcp"],
+      "env": {
+        "NIMBUS_API_KEY": "nimbus_your_key_here"
+      }
+    }
+  }
+}
+```
+
+---
+
+## Windsurf
+
+Add to your MCP config:
+
+**macOS/Linux:** `~/.codeium/windsurf/mcp_config.json`
+**Windows:** `%USERPROFILE%\.codeium\windsurf\mcp_config.json`
+
+```json
+{
+  "mcpServers": {
+    "nimbus": {
+      "command": "npx",
+      "args": ["-y", "@nimbus-app/mcp"],
+      "env": {
+        "NIMBUS_API_KEY": "nimbus_your_key_here"
+      }
+    }
+  }
+}
+```
+
+---
+
+## ChatGPT Desktop
+
+Requires ChatGPT Pro/Team/Enterprise with Developer Mode enabled.
+
+1. Open ChatGPT Desktop → **Settings** → **Developer** → Enable **Developer Mode**
+2. Under **MCP Servers**, click **Add Server**
+3. Choose **stdio** transport and configure:
+   - **Command:** `npx`
+   - **Args:** `-y @nimbus-app/mcp`
+   - **Env:** `NIMBUS_API_KEY` = `nimbus_your_key_here`
+
+Or edit the config file directly:
 
-Quit and reopen Claude Desktop. You should see "nimbus" in the MCP servers list.
+**macOS:** `~/Library/Application Support/com.openai.chat/mcp.json`
+
+```json
+{
+  "mcpServers": {
+    "nimbus": {
+      "command": "npx",
+      "args": ["-y", "@nimbus-app/mcp"],
+      "env": {
+        "NIMBUS_API_KEY": "nimbus_your_key_here"
+      }
+    }
+  }
+}
+```
+
+---
+
+## OpenAI Codex CLI
+
+One command:
+
+```bash
+codex mcp add nimbus --env NIMBUS_API_KEY=your_key -- npx -y @nimbus-app/mcp
+```
+
+Or add manually to `~/.codex/config.toml`:
+
+```toml
+[mcp_servers.nimbus]
+command = "npx"
+args = ["-y", "@nimbus-app/mcp"]
+
+[mcp_servers.nimbus.env]
+NIMBUS_API_KEY = "nimbus_your_key_here"
+```
+
+---
+
+## Any MCP-Compatible Tool
+
+The server works with any tool that supports the [Model Context Protocol](https://modelcontextprotocol.io). Use stdio transport:
+
+- **Command:** `npx -y @nimbus-app/mcp`
+- **Environment:** `NIMBUS_API_KEY=your_key`
+- **Transport:** stdio
+
+Or install globally first:
+
+```bash
+npm install -g @nimbus-app/mcp
+```
+
+Then use `nimbus-mcp` as the command instead of `npx -y @nimbus-app/mcp`.
+
+---
 
 ## Available Tools
 
-Once connected, Claude has access to these tools:
+Once connected, your AI assistant has access to:
 
 ### `nimbus_search_tasks`
 
@@ -69,7 +202,6 @@ Search for recorded workflows/sessions by natural language query. Returns matchi
 **Example prompts:**
 - "Find workflows where I submitted homework"
 - "Show my recent workflows about expense reports"
-- "Search my workflows for VS Code setup"
 
 ### `nimbus_get_workflow_steps`
 
@@ -78,7 +210,6 @@ Get detailed task executions and ordered workflow steps for a specific workflow.
 **Example prompts:**
 - "Show the step-by-step flow for this workflow"
 - "Get workflow steps including screenshots"
-- "Explain the executions in this workflow"
 
 ### `nimbus_search_platforms`
 
@@ -92,18 +223,10 @@ Search for platforms (apps/websites) you work with. Returns platform knowledge a
 
 Get full details for a specific platform, including accumulated knowledge about how it works and all tasks you perform on it.
 
-**Example prompts:**
-- "Show me everything about how I use VS Code"
-- "Get full details on this platform"
-
 ### `nimbus_ask_user`
 
 Ask you a question (you'll be notified in the Nimbus app).
 
-**Example prompts:**
-- "Ask the user which email to use for this form"
-- "Check with the user if they want to proceed"
-
 ### `nimbus_get_question_status`
 
 Check if you've answered a question.
@@ -142,29 +265,11 @@ Would you like me to walk you through this step by step?
 | `NIMBUS_API_KEY` | Your Nimbus API key (required) | - |
 | `NIMBUS_API_URL` | API endpoint URL | `https://api.nimbusai.cloud/mcp/v1` |
 
-### Staging/Development
-
-To use the staging API:
-
-```json
-{
-  "mcpServers": {
-    "nimbus": {
-      "command": "nimbus-mcp",
-      "env": {
-        "NIMBUS_API_KEY": "nimbus_your_key",
-        "NIMBUS_API_URL": "https://api.staging.nimbusai.cloud/mcp/v1"
-      }
-    }
-  }
-}
-```
-
 ## Troubleshooting
 
 ### "NIMBUS_API_KEY is required"
 
-Make sure you've added the API key to your Claude Desktop config and restarted Claude.
+Make sure you've added the API key to your config and restarted the tool.
 
 ### "Invalid or missing API key"
 
@@ -179,20 +284,16 @@ The API has limits of:
 
 Wait a moment and try again.
 
-### Server not appearing in Claude
+### Server not appearing
 
 1. Check your config file path is correct
 2. Ensure the JSON is valid (no trailing commas)
-3. Completely quit and restart Claude Desktop
-4. Check Claude's logs for errors
+3. Completely quit and restart the app
+4. Try running manually: `NIMBUS_API_KEY=your_key npx @nimbus-app/mcp`
 
-### Testing the server manually
-
-```bash
-NIMBUS_API_KEY=your_key nimbus-mcp
-```
+### Node.js not found
 
-The server should start and wait for MCP protocol messages on stdin.
+You need Node.js 18+. Download from [nodejs.org](https://nodejs.org) (LTS version).
 
 ## Privacy & Security
 
@@ -209,4 +310,4 @@ The server should start and wait for MCP protocol messages on stdin.
 
 ## License
 
-MIT
+Proprietary. Copyright Nimbus. All rights reserved.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@nimbus-app/mcp",
-  "version": "1.0.0",
-  "description": "MCP server for Nimbus - Access your workflow memory from Claude",
+  "version": "1.0.2",
+  "description": "MCP server for Nimbus - Access your workflow memory from any AI assistant",
   "author": "Nimbus <support@nimbusai.cloud>",
   "license": "UNLICENSED",
   "repository": {
@@ -17,10 +17,18 @@
     "mcp",
     "model-context-protocol",
     "claude",
+    "cursor",
+    "windsurf",
     "ai",
     "workflow",
     "automation",
-    "nimbus"
+    "nimbus",
+    "chatgpt",
+    "codex",
+    "openai",
+    "screen-recording",
+    "task-memory",
+    "productivity"
   ],
   "type": "module",
   "main": "./dist/index.js",