{"_id":"750words-mcp","_rev":"7-c9a0ad77ed90ae4bbf748f2b9da385b3","name":"750words-mcp","dist-tags":{"latest":"0.4.0"},"versions":{"0.1.0":{"name":"750words-mcp","version":"0.1.0","keywords":["mcp","750words","journal","writing","ai","claude","model-context-protocol"],"license":"MIT","_id":"750words-mcp@0.1.0","maintainers":[{"name":"busterbenson","email":"buster@benson.fm"}],"bin":{"750words-mcp":"dist/index.js"},"dist":{"shasum":"e1fe320128cbc2d21810424887bffa1932421b3c","tarball":"https://registry.npmjs.org/750words-mcp/-/750words-mcp-0.1.0.tgz","fileCount":15,"integrity":"sha512-icRB0hVicWFPOsMpXfLXbphNOhmYWtZcLjkjwjfgAfg1sJTXqDlKHdMWfMreyzPJqfBynwlQOl9nibQULtjRFw==","signatures":[{"sig":"MEQCIFpGgoycQmsG2LDOqJJv1kmz3w535DhYq+UZMTG/++yKAiBGedADdaMzlFyyC/EtaPVsMsZrKiyp48g/xl00x43D6g==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":12960},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"gitHead":"511f16de9d504043962d8a7a14306fcebacce0a0","scripts":{"dev":"tsc --watch","build":"tsc","start":"node dist/index.js","prepublishOnly":"tsc"},"_npmUser":{"name":"busterbenson","email":"buster@benson.fm"},"_npmVersion":"10.8.2","description":"MCP server for 750 Words — connect your writing archive to AI tools like Claude Desktop, Cursor, and more","directories":{},"_nodeVersion":"20.19.4","dependencies":{"zod":"^3.23.0","@modelcontextprotocol/sdk":"^1.12.1"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.5.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/750words-mcp_0.1.0_1774250827485_0.6300327718424401","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"750words-mcp","version":"0.1.1","keywords":["mcp","750words","journal","writing","ai","claude","model-context-protocol"],"license":"MIT","_id":"750words-mcp@0.1.1","maintainers":[{"name":"busterbenson","email":"buster@benson.fm"}],"bin":{"750words-mcp":"dist/index.js"},"dist":{"shasum":"9b306275a289f3337b45a41d80db274f3430a659","tarball":"https://registry.npmjs.org/750words-mcp/-/750words-mcp-0.1.1.tgz","fileCount":15,"integrity":"sha512-3cbqvS+E1rqR6mLCtfth24To9u+mRcDNtCf7mJeYkjHhhudeBSpJDKRmckzdY02je6zCU0yg9KEG5mtX32gfbg==","signatures":[{"sig":"MEQCIEfVF6GQ/0Xxlu8eTwxvV0qqxovSM2l70+XMuuvd0sxLAiARByl5BUBx3Wy9PmDSAG5PBT5NX+Qx5AclVoGcl1Exow==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":12991},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"gitHead":"511f16de9d504043962d8a7a14306fcebacce0a0","scripts":{"dev":"tsc --watch","build":"tsc","start":"node dist/index.js","prepublishOnly":"tsc"},"_npmUser":{"name":"busterbenson","email":"buster@benson.fm"},"_npmVersion":"10.8.2","description":"MCP server for 750 Words — connect your writing archive to AI tools like Claude Desktop, Cursor, and more","directories":{},"_nodeVersion":"20.19.4","dependencies":{"zod":"^3.23.0","@modelcontextprotocol/sdk":"^1.12.1"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.5.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/750words-mcp_0.1.1_1774251007092_0.14176190524831678","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"750words-mcp","version":"0.1.2","keywords":["mcp","750words","journal","writing","ai","claude","model-context-protocol"],"license":"MIT","_id":"750words-mcp@0.1.2","maintainers":[{"name":"busterbenson","email":"buster@benson.fm"}],"bin":{"750words-mcp":"dist/index.js"},"dist":{"shasum":"200acb36949c151568af3fda4bd142feab5439f2","tarball":"https://registry.npmjs.org/750words-mcp/-/750words-mcp-0.1.2.tgz","fileCount":16,"integrity":"sha512-tsg7D2flD2gE1doe72xgfFoe+WbB7Z1bpwc4eCLi4g5RnBwQL8CQ5fbNNkw5xLp8+LN1c9XnqTf3ok6bJDepvw==","signatures":[{"sig":"MEUCIQDQuBUZt0kpxtv9dVC8L3rG1fXNKOzb6rbXGF4HuVXJHgIgGC24DCfUf0xx2IoOH44NfAKg2X1UcxZw8W0wcTRvkTQ=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":15946},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"gitHead":"511f16de9d504043962d8a7a14306fcebacce0a0","scripts":{"dev":"tsc --watch","build":"tsc","start":"node dist/index.js","prepublishOnly":"tsc"},"_npmUser":{"name":"busterbenson","email":"buster@benson.fm"},"_npmVersion":"10.8.2","description":"MCP server for 750 Words — connect your writing archive to AI tools like Claude Desktop, Cursor, and more","directories":{},"_nodeVersion":"20.19.4","dependencies":{"zod":"^3.23.0","@modelcontextprotocol/sdk":"^1.12.1"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.5.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/750words-mcp_0.1.2_1774251088585_0.4343508039136583","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"750words-mcp","version":"0.1.3","keywords":["mcp","750words","journal","writing","ai","claude","model-context-protocol"],"license":"MIT","_id":"750words-mcp@0.1.3","maintainers":[{"name":"busterbenson","email":"buster@benson.fm"}],"bin":{"750words-mcp":"dist/index.js"},"dist":{"shasum":"a458e0b379396f9acce973c29695f7322c596cf5","tarball":"https://registry.npmjs.org/750words-mcp/-/750words-mcp-0.1.3.tgz","fileCount":16,"integrity":"sha512-wbCAV6rQrqK4+J59JQcPuQE0xl/sgdD6oGO+nSBLoU8TwGhX8ahmf8dC3gwLiIkjGfZ+JL+00AMIgMy+2nDGuw==","signatures":[{"sig":"MEUCIQDbnWuQNUJokmuG4IQSAd9iO3ZoXoTyZeSIIP6MZk695gIgJTqTQ//tFT8APAEtpfZvN6g6RzsON9Sgq6KIEonhog0=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":15933},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"gitHead":"511f16de9d504043962d8a7a14306fcebacce0a0","scripts":{"dev":"tsc --watch","build":"tsc","start":"node dist/index.js","prepublishOnly":"tsc"},"_npmUser":{"name":"busterbenson","email":"buster@benson.fm"},"_npmVersion":"10.8.2","description":"MCP server for 750 Words — connect your writing archive to AI tools like Claude Desktop, Cursor, and more","directories":{},"_nodeVersion":"20.19.4","dependencies":{"zod":"^3.23.0","@modelcontextprotocol/sdk":"^1.12.1"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.5.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/750words-mcp_0.1.3_1774251508517_0.5849562717121337","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"750words-mcp","version":"0.2.0","keywords":["mcp","750words","journal","writing","ai","claude","model-context-protocol"],"license":"MIT","_id":"750words-mcp@0.2.0","maintainers":[{"name":"busterbenson","email":"buster@benson.fm"}],"bin":{"750words-mcp":"dist/index.js"},"dist":{"shasum":"8b8c7500e0460f4063923c1d4dcadec668b64136","tarball":"https://registry.npmjs.org/750words-mcp/-/750words-mcp-0.2.0.tgz","fileCount":20,"integrity":"sha512-QJ5tdwEUejv9JwZuEDMNsSeuPgWYJLvRfLyEb7AdhfVvF3vrdqUoJnrTsdOwG0ijth2T/ElnzGewSgb+PDcPIg==","signatures":[{"sig":"MEUCIQCjx2K/DJfPWOUUSQruD3XOg8rDkxKLRENw2L7U1x+5TgIgPMxtQQq7yJhpp/NphmnmeVHg6+a6boRATPy/K8Bk7r4=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":19522},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"gitHead":"293e0011ceeb7cf1570aa077cc0534e98ff0dc84","scripts":{"dev":"tsc --watch","build":"tsc","start":"node dist/index.js","prepublishOnly":"tsc"},"_npmUser":{"name":"busterbenson","email":"buster@benson.fm"},"_npmVersion":"10.8.2","description":"MCP server for 750 Words — connect your writing archive to AI tools like Claude Desktop, Cursor, and more","directories":{},"_nodeVersion":"20.19.4","dependencies":{"zod":"^3.23.0","@modelcontextprotocol/sdk":"^1.12.1"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.5.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/750words-mcp_0.2.0_1774292575339_0.2668955965492974","host":"s3://npm-registry-packages-npm-production"}},"0.3.0":{"name":"750words-mcp","version":"0.3.0","keywords":["mcp","750words","journal","writing","ai","claude","model-context-protocol"],"license":"MIT","_id":"750words-mcp@0.3.0","maintainers":[{"name":"busterbenson","email":"buster@benson.fm"}],"bin":{"750words-mcp":"dist/index.js"},"dist":{"shasum":"016c7c93bb3647a6ee76f6f8e48c10782ebfdefd","tarball":"https://registry.npmjs.org/750words-mcp/-/750words-mcp-0.3.0.tgz","fileCount":26,"integrity":"sha512-AoOQKbCl3NZkaPt/9pjSF8fF6gltcZ6dX+fYg2N56E/l8TPzXWIoJhVsCMa4Mut3Yr3RLp34XGAoYYNw13OgXg==","signatures":[{"sig":"MEQCIHB5GK3Zgnt9vtiWmKmt5YDYEi7Y+7IkjqVmR3W11QYGAiB4jPLH1DVbKjidrmgxUvp4nbn+OD6lUW8UgEOeW33oWg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":32835},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"gitHead":"1f38fedbdc4d13ce0cc74f4cfa55f6c527d21bae","scripts":{"dev":"tsc --watch","build":"tsc","start":"node dist/index.js","prepublishOnly":"tsc"},"_npmUser":{"name":"busterbenson","email":"buster@benson.fm"},"_npmVersion":"10.8.2","description":"MCP server for 750 Words — connect your writing archive to AI tools like Claude Desktop, Cursor, and more","directories":{},"_nodeVersion":"20.19.4","dependencies":{"zod":"^3.23.0","@modelcontextprotocol/sdk":"^1.12.1"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.5.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/750words-mcp_0.3.0_1774302114617_0.185234300433736","host":"s3://npm-registry-packages-npm-production"}},"0.4.0":{"name":"750words-mcp","version":"0.4.0","description":"MCP server for 750 Words — connect your writing archive to AI tools like Claude, Cursor, ChatGPT, and more","type":"module","main":"dist/index.js","bin":{"750words-mcp":"dist/index.js"},"scripts":{"build":"tsc","dev":"tsc --watch","start":"node dist/index.js","start:http":"MCP_TRANSPORT=http node dist/index.js","prepublishOnly":"tsc"},"keywords":["mcp","750words","journal","writing","ai","claude","model-context-protocol"],"license":"MIT","engines":{"node":">=18"},"dependencies":{"@modelcontextprotocol/sdk":"^1.12.1","express":"^5.1.0","zod":"^3.23.0"},"devDependencies":{"@types/express":"^5.0.0","@types/node":"^20.0.0","typescript":"^5.5.0"},"gitHead":"f40618df39d69f6c6de09fd22f6b1c694bff8d80","types":"./dist/index.d.ts","_id":"750words-mcp@0.4.0","_nodeVersion":"20.19.4","_npmVersion":"11.12.1","dist":{"integrity":"sha512-2DbjWp277haZBWg1Wua8ErKERcKw400KbTjqamktSHlvCIPV2fHGJcZYqtJW5Ai8b16dmdHYylViwzCSO4Gw0g==","shasum":"b6feb6baada4b0612e8cdcf1297753ae2eb9754a","tarball":"https://registry.npmjs.org/750words-mcp/-/750words-mcp-0.4.0.tgz","fileCount":28,"unpackedSize":43834,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDW12FTDffDB8ooCNNWxdXOcfVMY42e5DzMNuEtWYd7HQIhALcD5DC30iQXT1KZWeYS704bM74zsD6a/346+4BmCPUM"}]},"_npmUser":{"name":"busterbenson","email":"buster@benson.fm"},"directories":{},"maintainers":[{"name":"busterbenson","email":"buster@benson.fm"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/750words-mcp_0.4.0_1775679268811_0.43523147454338185"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-23T07:27:07.485Z","modified":"2026-04-08T20:14:29.121Z","0.1.0":"2026-03-23T07:27:07.658Z","0.1.1":"2026-03-23T07:30:07.239Z","0.1.2":"2026-03-23T07:31:28.748Z","0.1.3":"2026-03-23T07:38:28.660Z","0.2.0":"2026-03-23T19:02:55.494Z","0.3.0":"2026-03-23T21:41:54.758Z","0.4.0":"2026-04-08T20:14:29.019Z"},"license":"MIT","keywords":["mcp","750words","journal","writing","ai","claude","model-context-protocol"],"description":"MCP server for 750 Words — connect your writing archive to AI tools like Claude, Cursor, ChatGPT, and more","maintainers":[{"name":"busterbenson","email":"buster@benson.fm"}],"readme":"# 750words-mcp\n\nAn [MCP server](https://modelcontextprotocol.io) that connects your [750 Words](https://750words.com) writing archive to AI tools like Claude Desktop, Claude Code, Cursor, and more.\n\nSearch your entries, pull up what you wrote on any date, explore patterns in your writing — all through natural conversation with your AI tool.\n\n## Setup\n\nYou'll need a 750 Words Fancy membership and an access token. Generate one at [750words.com/account/mcp](https://750words.com/account/mcp).\n\n### Claude Code (easiest)\n\n```bash\nclaude mcp add 750words --scope user \\\n  -e MCP_750WORDS_ACCESS_TOKEN=your_access_token \\\n  -e MCP_750WORDS_REFRESH_TOKEN=your_refresh_token \\\n  -- npx 750words-mcp\n```\n\n### Claude Desktop\n\nAdd to your `claude_desktop_config.json` (Settings > Developer > Edit Config):\n\n```json\n{\n  \"mcpServers\": {\n    \"750words\": {\n      \"command\": \"npx\",\n      \"args\": [\"750words-mcp\"],\n      \"env\": {\n        \"MCP_750WORDS_ACCESS_TOKEN\": \"your_access_token\",\n        \"MCP_750WORDS_REFRESH_TOKEN\": \"your_refresh_token\"\n      }\n    }\n  }\n}\n```\n\nThen quit and reopen Claude Desktop.\n\n### Other tools\n\nThe MCP server works with any MCP-compatible client. Set the command to `npx 750words-mcp` and pass the two environment variables above.\n\n## Tools\n\n| Tool | Description |\n|---|---|\n| `search_entries` | Full-text search across your archive. Supports AND, OR, exact phrases, and exclusion. |\n| `get_entry` | Get the complete text of an entry by date, with metadata and analysis. |\n| `on_this_day` | See what you wrote on this date in past years. |\n| `get_writing_stats` | Overview stats: total entries, words, streaks, completion rate. |\n| `list_metadata` | Browse your #hashtags, @mentions, and labels with counts. |\n| `list_courses` | See all courses you've participated in. |\n| `request_export` | Request a full journal export as a ZIP file. |\n| `get_export_status` | Check if your export is ready to download. |\n\n## Things to try\n\n- \"What did I write about yesterday?\"\n- \"Search for entries about career change\"\n- \"What did I write on this day in past years?\"\n- \"Find entries where I mentioned @sarah\"\n- \"What are my writing stats for this year?\"\n- \"Export my entire journal\"\n\n## Privacy\n\nYour entries travel from 750 Words servers directly to your computer. When you ask your AI about your writing, that conversation happens entirely in your AI tool, using your own account. 750 Words never sees your questions or the AI's responses.\n\nThe access token is read-only — it can search and retrieve entries but cannot modify or delete anything.\n\n## Environment variables\n\n| Variable | Required | Description |\n|---|---|---|\n| `MCP_750WORDS_ACCESS_TOKEN` | Yes | Your access token from 750words.com/account/mcp |\n| `MCP_750WORDS_REFRESH_TOKEN` | Yes | Your refresh token (used to automatically renew expired access tokens) |\n| `MCP_750WORDS_API_URL` | No | API endpoint override (defaults to production) |\n\n## License\n\nMIT\n","readmeFilename":"README.md"}