substack-notes-mcp 1.1.0

package/README.md

@@ -0,0 +1,72 @@
+# Substack Notes MCP
+
+Create, schedule, and manage your Substack notes from any AI assistant — Claude Desktop, Claude Code, or Cursor.
+
+Built by [Jenny Ouyang](https://buildtolaunch.substack.com).
+
+## Setup
+
+### 1. Get your API token
+
+Go to [quickviralnotes.com/settings](https://quickviralnotes.com/settings) and generate an MCP API token.
+
+### 2. Connect your AI assistant
+
+**Claude Desktop** — add to your `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "substack-notes": {
+      "command": "npx",
+      "args": ["-y", "substack-notes-mcp", "--token", "YOUR_TOKEN"]
+    }
+  }
+}
+```
+
+**Claude Code** — run:
+
+```bash
+claude mcp add substack-notes -- npx -y substack-notes-mcp --token YOUR_TOKEN
+```
+
+**Cursor** — add to your MCP settings:
+
+```json
+{
+  "mcpServers": {
+    "substack-notes": {
+      "command": "npx",
+      "args": ["-y", "substack-notes-mcp", "--token", "YOUR_TOKEN"]
+    }
+  }
+}
+```
+
+Or connect directly via Streamable HTTP:
+
+- **URL:** `https://qvn-mcp.vercel.app/mcp`
+- **Header:** `Authorization: Bearer YOUR_TOKEN`
+
+## Available Tools
+
+| Tool | Description |
+|------|-------------|
+| `get_notes_dashboard` | View published and planned notes with category distributions |
+| `get_published_notes` | List your recently published notes |
+| `get_planned_notes` | View planned notes and open scheduling slots |
+| `get_unscheduled_notes` | Get notes ready to be scheduled |
+| `create_note` | Create a new note with HTML content and category |
+| `schedule_note` | Set or update the planned date for a note |
+| `unschedule_note` | Remove the planned date from a note |
+| `mark_note_published` | Mark a note as published with optional Substack URL |
+
+## Requirements
+
+- Node.js 18+
+- A Quick Viral Notes account with an active subscription
+
+## License
+
+MIT

package/bin/cli.mjs

@@ -0,0 +1,49 @@
+#!/usr/bin/env node
+
+/**
+ * Substack Notes MCP — thin CLI that proxies STDIO to the remote MCP server.
+ *
+ * Usage (Claude Desktop / Claude Code config):
+ *   npx substack-notes-mcp --token YOUR_TOKEN
+ *
+ * This spawns mcp-remote which bridges STDIO ↔ Streamable HTTP,
+ * so local MCP clients can talk to the Vercel-hosted server.
+ */
+
+import { spawn } from 'child_process';
+import { createRequire } from 'module';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+
+const MCP_SERVER_URL = 'https://qvn-mcp.vercel.app/mcp';
+
+function getToken() {
+  const tokenIdx = process.argv.indexOf('--token');
+  if (tokenIdx === -1 || !process.argv[tokenIdx + 1]) {
+    console.error('Error: --token is required.');
+    console.error('Usage: npx substack-notes-mcp --token YOUR_QVN_TOKEN');
+    console.error('Generate a token at https://quickviralnotes.com/settings');
+    process.exit(1);
+  }
+  return process.argv[tokenIdx + 1];
+}
+
+const token = getToken();
+
+const require = createRequire(import.meta.url);
+const mcpRemotePath = require.resolve('mcp-remote/dist/proxy.js');
+
+const child = spawn(
+  process.execPath,
+  [
+    mcpRemotePath,
+    MCP_SERVER_URL,
+    '--header',
+    `Authorization: Bearer ${token}`,
+    '--transport',
+    'http-only',
+  ],
+  { stdio: 'inherit' }
+);
+
+child.on('exit', (code) => process.exit(code ?? 0));

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "substack-notes-mcp",
+  "version": "1.1.0",
+  "description": "MCP server for Substack Notes — create, schedule, and manage your notes from any AI assistant.",
+  "author": "Jenny Ouyang",
+  "license": "MIT",
+  "homepage": "https://buildtolaunch.substack.com",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/jenny-ouyang/qvn-mcp"
+  },
+  "keywords": [
+    "mcp",
+    "substack",
+    "notes",
+    "scheduling",
+    "ai",
+    "claude",
+    "cursor",
+    "model-context-protocol"
+  ],
+  "bin": {
+    "substack-notes-mcp": "./bin/cli.mjs"
+  },
+  "files": [
+    "bin/",
+    "README.md"
+  ],
+  "dependencies": {
+    "mcp-remote": "^0.1.38"
+  }
+}