{"_id":"juncts-mcp","_rev":"3-acfdc96560c9421ce9be706451f2bd85","name":"juncts-mcp","dist-tags":{"latest":"0.1.1"},"versions":{"0.0.0-stage":{"name":"juncts-mcp","version":"0.0.0-stage","_id":"juncts-mcp@0.0.0-stage","stub":true,"maintainers":[{"name":"juncts","email":"joe@juncts.com"}],"dist":{"shasum":"8645477aa7d0e2bebad1cff82ed8b17defbe2472","tarball":"https://registry.npmjs.org/juncts-mcp/-/juncts-mcp-0.0.0-stage.tgz","fileCount":2,"integrity":"sha512-Vsw4jY4UDPijVA3ZzZNXmjh9NrG/N2jmDKF7KHAJzkHpcllSgleWcQ+RQrAo8G2IxmZ7EcK5Q5CIlklDg3msfA==","signatures":[{"sig":"MEQCIDen/JydQSZfFRy7PfAYL9s4GIb1yYh4ui0tvfLlBTwDAiBIRKZukCrmu5P9y/e9/jEeP+xgPlFCe68jHf4V60AjwA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":332},"_npmUser":{"name":"juncts","email":"joe@juncts.com"},"description":"Temporary package placeholder for staged publishing","directories":{}},"0.1.0":{"name":"juncts-mcp","version":"0.1.0","keywords":["mcp","model-context-protocol","mcp-server","claude","claude-code","claude-desktop","codex","cursor","ai-agent","inbox","linkedin","x","twitter","instagram","whatsapp","juncts"],"license":"UNLICENSED","_id":"juncts-mcp@0.1.0","maintainers":[{"name":"juncts","email":"joe@juncts.com"}],"homepage":"https://juncts.com","bin":{"juncts-mcp":"juncts-mcp.mjs"},"dist":{"shasum":"bdcc695b1437ef7fcfd5315293ac8c37400cc452","tarball":"https://registry.npmjs.org/juncts-mcp/-/juncts-mcp-0.1.0.tgz","fileCount":3,"integrity":"sha512-xXC70v/9ucyq0fjBH8SFV5RLrwI6sVDsJ7igLb7CNX8wOO2aR6CrA4sPbD80uyROImO0UgSTNuCU6WH/8Gumaw==","signatures":[{"sig":"MEYCIQDzujN6FSSd28BJeIH50quZDD3Joa53UpOx2GWVNC2KTwIhALS6v/xZ0u99InKCXMHVzWO912jHc8MilCnrOeXB+2qP","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEQCIGR88dPo57AGLRehsjxqlXIQDua/AwJyJyPKXDd/0QLkAiAD4bJpwnfkA2WPMWc7ZrWHkgJ+WOZ/6dhRymTdcjSoTA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1565259},"type":"module","engines":{"node":">=18"},"_npmUser":{"name":"juncts","email":"joe@juncts.com"},"_npmVersion":"10.9.8","description":"Let Claude, Codex, Cursor and other AI agents read, triage and answer your LinkedIn, X, Instagram and WhatsApp messages in Juncts.","directories":{},"_nodeVersion":"22.23.1","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/juncts-mcp_0.1.0_1792330463735_0.7853289850368859","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"_id":"juncts-mcp@0.1.1","bin":{"juncts-mcp":"juncts-mcp.mjs"},"dist":{"shasum":"ae068383b7caa87e9603bf6c36bda6c9f96dc9a1","tarball":"https://registry.npmjs.org/juncts-mcp/-/juncts-mcp-0.1.1.tgz","fileCount":3,"integrity":"sha512-ZVVtvt7MCAbYtD6uTNoA49g9TswMeeeuWG+T2Ld/lWphtI44mbGuqv+3yGXbbxbGAIvjTPGC7C4jPVKiwwnVkQ==","signatures":[{"sig":"MEYCIQC/kV2ix7reO0PCsgCo/wTBln8CQx4nQlLG+UI4agZPqwIhAO3Zr0EsEX+ZHCReLKNQo5vSUZQFVHJQpZqZ4oh9BE3i","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIFXsNTWZ6VumzZYNY6w+SStRMlwaB4gUYFg4/NGH9VnVAiEA1VjGvDdPHgaaiATvkGef6vKcH/9O+V4/gI2mtNE6cBo="}],"unpackedSize":1567144},"name":"juncts-mcp","type":"module","engines":{"node":">=18"},"license":"UNLICENSED","version":"0.1.1","_npmUser":{"name":"juncts","email":"joe@juncts.com"},"homepage":"https://juncts.com","keywords":["mcp","model-context-protocol","mcp-server","claude","claude-code","claude-desktop","codex","cursor","ai-agent","inbox","linkedin","x","twitter","instagram","whatsapp","juncts"],"_npmVersion":"10.9.8","description":"Let Claude, Codex, Cursor and other AI agents read, triage and answer your LinkedIn, X, Instagram and WhatsApp messages in Juncts.","directories":{},"maintainers":[{"name":"juncts","email":"joe@juncts.com"}],"_nodeVersion":"22.23.1","_hasShrinkwrap":false,"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/juncts-mcp_0.1.1_1792331417107_0.7570886897595008"}}},"time":{"created":"2026-10-18T13:33:08.095Z","modified":"2026-10-18T13:50:17.441Z","0.0.0-stage":"2026-10-18T13:33:08.095Z","0.1.0":"2026-10-18T13:34:23.845Z","0.1.1":"2026-10-18T13:50:17.194Z"},"license":"UNLICENSED","homepage":"https://juncts.com","keywords":["mcp","model-context-protocol","mcp-server","claude","claude-code","claude-desktop","codex","cursor","ai-agent","inbox","linkedin","x","twitter","instagram","whatsapp","juncts"],"description":"Let Claude, Codex, Cursor and other AI agents read, triage and answer your LinkedIn, X, Instagram and WhatsApp messages in Juncts.","maintainers":[{"name":"juncts","email":"joe@juncts.com"}],"readme":"# juncts-mcp\n\nConnect your AI agent to [Juncts](https://juncts.com), the unified inbox for LinkedIn, X, Instagram and WhatsApp.\n\nWith it, Claude Code, Codex, Claude Desktop, Cursor, VS Code, Windsurf, Gemini CLI or any other MCP client can read your conversations, triage them (archive, label, star, snooze, mark read), and draft or send replies. Every action shows up live in Juncts and can be undone there.\n\n## Set up\n\nYou need [Node.js](https://nodejs.org) 18 or newer and Juncts open in your browser.\n\n```sh\nnpx -y juncts-mcp setup\n```\n\nThis finds the AI apps installed on your computer, asks which ones to connect, and adds Juncts to each. Then:\n\n1. In Juncts, open **Settings → Agents** and choose what agents may do.\n2. Restart your AI app.\n3. Ask it something like \"What's new in my inbox?\"\n\nOptions:\n\n```sh\nnpx -y juncts-mcp setup --client claude-code,cursor   # only these (ids: claude-code, codex, claude-desktop, cursor, vscode, windsurf, gemini)\nnpx -y juncts-mcp setup --yes                         # don't ask, connect everything found\nnpx -y juncts-mcp setup --print                       # just show the config, change nothing\nnpx -y juncts-mcp setup --remove                      # disconnect Juncts again\nnpx -y juncts-mcp doctor                              # check that everything works\n```\n\nSetup is safe to run again: it updates its own entry and never duplicates it. Before changing a config file it saves a copy next to it as `<file>.juncts-backup`, and it leaves a file it can't read alone.\n\n**Claude Desktop without a terminal:** download [juncts.mcpb](https://juncts.com/downloads/juncts.mcpb) and double-click it. Claude Desktop installs it with its own Node.js.\n\n## Manual setup\n\nIf you prefer to edit config files yourself, add one of these.\n\n**Claude Code**\n\n```sh\nclaude mcp add --scope user juncts -- npx -y juncts-mcp\n```\n\n**Codex**: `codex mcp add juncts -- npx -y juncts-mcp`, or in `~/.codex/config.toml`:\n\n```toml\n[mcp_servers.juncts]\ncommand = \"npx\"\nargs = [\"-y\", \"juncts-mcp\"]\n```\n\n**Cursor** (`~/.cursor/mcp.json`), **Windsurf** (`~/.codeium/windsurf/mcp_config.json`) and **Gemini CLI** (`~/.gemini/settings.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"juncts\": { \"command\": \"npx\", \"args\": [\"-y\", \"juncts-mcp\"] }\n  }\n}\n```\n\n**VS Code**: `code --add-mcp '{\"name\":\"juncts\",\"command\":\"npx\",\"args\":[\"-y\",\"juncts-mcp\"]}'`, or run **MCP: Open User Configuration** and add:\n\n```json\n{\n  \"servers\": {\n    \"juncts\": { \"type\": \"stdio\", \"command\": \"npx\", \"args\": [\"-y\", \"juncts-mcp\"] }\n  }\n}\n```\n\n**Claude Desktop** (Settings → Developer → Edit Config). Claude Desktop doesn't see your shell's `PATH`, so use absolute paths. The easiest way is `npx -y juncts-mcp setup --client claude-desktop`, which copies the server to `~/.juncts/bin/juncts-mcp.mjs` and writes:\n\n```json\n{\n  \"mcpServers\": {\n    \"juncts\": { \"command\": \"/absolute/path/to/node\", \"args\": [\"/Users/you/.juncts/bin/juncts-mcp.mjs\"] }\n  }\n}\n```\n\n**Other MCP clients**: run `npx -y juncts-mcp` as a stdio server. On Windows use `cmd /c npx -y juncts-mcp`.\n\n## What agents can do\n\nYou decide in Juncts → Settings → Agents. Agent access is **off** until you turn it on.\n\n| Level | Allows |\n| --- | --- |\n| Read | List and read conversations, people and invitations |\n| Drafts | Also write drafts for you to review and send yourself; nothing else changes |\n| Organize | Also archive, label, star, snooze, mark read, react, and undo |\n| Full | Also send, edit or unsend messages, delete, and answer invitations |\n\nSent replies wait in Juncts' undo-send window first, unless the agent asks to send instantly. Agents can send at most 50 messages a day by default (Settings → Agents → Daily send limit), and Settings → Agents lists what they did recently.\n\nPrefer **Drafts** for agents that run unattended. They read messages written by other people, which can contain instructions; Full lets an agent act on them by sending as you.\n\n## Privacy and trust\n\n- **Everything stays on your computer.** `juncts-mcp` runs locally and talks to the Juncts tab in your browser over `127.0.0.1`. It has no servers of its own and sends nothing to us.\n- **It never sees your passwords or cookies.** Your accounts stay signed in through the Juncts browser extension. The agent only gets what the Juncts tab hands it, at the level you chose.\n- **Websites can't use it.** Only the Juncts web app may connect as the app, and other local programs need a secret key stored in `~/.juncts/agent-token`, which web pages can't read.\n- **You can watch and undo.** Agent actions appear live in Juncts and go on its undo stack. Settings → Agents shows which agents are connected.\n- Your AI app does see the messages it reads, under that app's own privacy terms.\n\n## Troubleshooting\n\nRun `npx -y juncts-mcp doctor` first. It checks Node, the local port, the agent key, which apps are connected, and whether a Juncts tab is attached.\n\n- **\"Juncts is not connected\"**: open Juncts in your browser and go to Settings → Agents. Keep the tab open while the agent works.\n- **\"Agent access is off\" or \"needs 'full' access\"**: raise the level in Settings → Agents.\n- **The tools don't show up**: restart the AI app after setup. In Claude Code, `/mcp` lists servers.\n- **`npx` not found**: install Node.js 18+ from nodejs.org, then run setup again. For Claude Desktop, use the `.mcpb` download.\n- **Port 47615 is taken**: set `JUNCTS_MCP_PORT` in the MCP config's `env`, and the same number in Juncts under `localStorage['juncts:agentPort']`.\n- **Undo setup**: `npx -y juncts-mcp setup --remove`, or restore a `.juncts-backup` file.\n\nSeveral AI apps can be connected at once; they share one local connection to Juncts.\n","readmeFilename":"README.md"}