Catalog npm
PACKAGE EXPLORERView in registry

750words-mcp

npm

MCP server for 750 Words — connect your writing archive to AI tools like Claude, Cursor, ChatGPT, and more

750wordsaiclaudejournalmcpmodel-context-protocolwriting
Versions collected7
Direct dependencies6From release 0.4.0
Last observed20 Oct, 21:04 UTC

README

Current package documentation

750words-mcp

An MCP server that connects your 750 Words writing archive to AI tools like Claude Desktop, Claude Code, Cursor, and more.

Search your entries, pull up what you wrote on any date, explore patterns in your writing — all through natural conversation with your AI tool.

Setup

You'll need a 750 Words Fancy membership and an access token. Generate one at 750words.com/account/mcp.

Claude Code (easiest)

claude mcp add 750words --scope user \
  -e MCP_750WORDS_ACCESS_TOKEN=your_access_token \
  -e MCP_750WORDS_REFRESH_TOKEN=your_refresh_token \
  -- npx 750words-mcp

Claude Desktop

Add to your claude_desktop_config.json (Settings > Developer > Edit Config):

{
  "mcpServers": {
    "750words": {
      "command": "npx",
      "args": ["750words-mcp"],
      "env": {
        "MCP_750WORDS_ACCESS_TOKEN": "your_access_token",
        "MCP_750WORDS_REFRESH_TOKEN": "your_refresh_token"
      }
    }
  }
}

Then quit and reopen Claude Desktop.

Other tools

The MCP server works with any MCP-compatible client. Set the command to npx 750words-mcp and pass the two environment variables above.

Tools

ToolDescription
search_entriesFull-text search across your archive. Supports AND, OR, exact phrases, and exclusion.
get_entryGet the complete text of an entry by date, with metadata and analysis.
on_this_daySee what you wrote on this date in past years.
get_writing_statsOverview stats: total entries, words, streaks, completion rate.
list_metadataBrowse your #hashtags, @mentions, and labels with counts.
list_coursesSee all courses you've participated in.
request_exportRequest a full journal export as a ZIP file.
get_export_statusCheck if your export is ready to download.

Things to try

  • "What did I write about yesterday?"
  • "Search for entries about career change"
  • "What did I write on this day in past years?"
  • "Find entries where I mentioned @sarah"
  • "What are my writing stats for this year?"
  • "Export my entire journal"

Privacy

Your 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.

The access token is read-only — it can search and retrieve entries but cannot modify or delete anything.

Environment variables

VariableRequiredDescription
MCP_750WORDS_ACCESS_TOKENYesYour access token from 750words.com/account/mcp
MCP_750WORDS_REFRESH_TOKENYesYour refresh token (used to automatically renew expired access tokens)
MCP_750WORDS_API_URLNoAPI endpoint override (defaults to production)

License

MIT

Downloads & popularity

Awaiting observations

No metric observations yet

Download counts and popularity will appear here as the collector receives them.

Versions 7

Collected releases
VersionPublishedDirect dependenciesOpen version
0.4.0Registry latest8 Apr 20266
0.3.023 Mar 20264
0.2.023 Mar 20264
0.1.323 Mar 20264
0.1.223 Mar 20264
0.1.123 Mar 20264
0.1.023 Mar 20264

Package advisories

0
No matching advisories collected

This describes our collected data; it is not a security assessment.

Metadata history

Meaningful changes
Current collected state Current

Observed since 20 Oct, 21:04 UTC

No superseded metadata states collected. Unchanged observations do not create new revisions.

Record identity

package:223ac63c5bae37ebd81bd91f91e775360ce1fc7710f3db9f45534098ffb842ba