Skip to content
Back to search

weekend-folio

MarketplaceWorks with Claude CodeGitHub

Weekend Folio for AI assistants: an MCP connector and skills that turn saved links into your own magazine (PDF, Kindle or print).

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/davidmokos--weekend-folio-plugin/badge.svg)](/listings/davidmokos--weekend-folio-plugin)

HTML

<a href="/listings/davidmokos--weekend-folio-plugin"><img src="/api/listings/davidmokos--weekend-folio-plugin/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Each assistant gets the connector. Some also load the skills.

| Assistant | You get | How | | --- | --- | --- | | [Claude Code](#claude-code) | Connector and skills | Plugin | | [Claude](#claude) (web, desktop, mobile) | Connector | Custom connector | | [ChatGPT](#chatgpt) | Connector | Custom MCP server | | [Codex](#codex) | Connector and skills | Plugin | | [Cursor](#cursor) | Connector | Install link | | [Grok](#grok) | Connector, and skills in Grok Build | Custom connector or plugin | | [Gemini CLI](#gemini-cli) | Connector | Extension | | [VS Code and GitHub Copilot](#vs-code-and-github-copilot) | Connector, and skills in Copilot CLI | Install link or plugin | | [Other assistants](#other-assistants) | Connector | The address |

The first time the assistant uses a tool, it sends you to weekendfolio.com to sign in and to allow the connection.

Claude Code

/plugin install weekend-folio --marketplace davidmokos/weekend-folio-plugin

Then run `/mcp`, select `weekend-folio`, and sign in.

Before Claude Code 2.1.275, use two steps: `/plugin marketplace add davidmokos/weekend-folio-plugin`, then `/plugin install weekend-folio@weekend-folio`.

Claude

Open **Customize**, then **Connectors**. Select **Add**, then **Add custom connector**. Paste `https://weekendfolio.com/mcp`.

On a Team or Enterprise plan, an owner adds the connector first, in the organization settings. Claude has [the steps](https://claude.com/docs/connectors/custom/remote-mcp).

ChatGPT

Open [chatgpt.com/plugins](https://chatgpt.com/plugins), select the plus button, then **Add custom MCP server**. Paste `https://weekendfolio.com/mcp`.

Codex

codex plugin marketplace add davidmokos/weekend-folio-plugin
codex plugin add weekend-folio@weekend-folio

Cursor

**[Add Weekend Folio to Cursor](https://cursor.com/link/mcp/install?name=weekend-folio&config=eyJ1cmwiOiJodHRwczovL3dlZWtlbmRmb2xpby5jb20vbWNwIn0%3D)**

To add the skills too, see [Skills only](#skills-only).

Grok

- **Grok** (grok.com): open **Connectors**, select **New Connector**, then **Custom**. Paste `https://weekendfolio.com/mcp`. - **Grok Bot**: select **Add a custom connector**, type **Remote HTTPS**. Paste `https://weekendfolio.com/mcp` as the server URL. - **Grok Build**:

  grok plugin marketplace add davidmokos/weekend-folio-plugin
  grok plugin install weekend-folio --trust

Gemini CLI

gemini extensions install https://github.com/davidmokos/weekend-folio-plugin

Then run `/mcp auth weekend-folio` in Gemini CLI to sign in.

VS Code and GitHub Copilot

- **VS Code**: [install the connector](https://vscode.dev/redirect?url=vscode%3Amcp%2Finstall%3F%257B%2522name%2522%253A%2522weekend-folio%2522%252C%2522type%2522%253A%2522http%2522%252C%2522url%2522%253A%2522https%253A%252F%252Fweekendfolio.com%252Fmcp%2522%257D). - **Copilot CLI**:

  copilot plugin install davidmokos/weekend-folio-plugin:plugins/weekend-folio

Other assistants

Add a remote MCP server with this address. The assistant finds the sign-in from there.

{
  "mcpServers": {
    "weekend-folio": {
      "type": "http",
      "url": "https://weekendfolio.com/mcp"
    }
  }
}

| | | | --- | --- | | Transport | Streamable HTTP | | Sign-in | OAuth 2.1 with PKCE. The server answers `401` and points to its OAuth metadata. | | Client registration | Dynamic client registration, or a client ID metadata document | | Scopes | `library`, and `print` if the reader allows it |

Skills only

The [skills CLI](https://skills.sh/docs/cli) copies the three skills into the assistant that you select. The skills need the connector.

npx skills@latest add davidmokos/weekend-folio-plugin

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 19 lines
  1. {
  2. "name": "weekend-folio",
  3. "owner": {
  4. "name": "Weekend Folio",
  5. "email": "hello@weekendfolio.com",
  6. "url": "https://weekendfolio.com"
  7. },
  8. "metadata": {
  9. "description": "The Weekend Folio plugin: a connector and skills for your own magazine of saved articles."
  10. },
  11. "plugins": [
  12. {
  13. "name": "weekend-folio",
  14. "source": "./plugins/weekend-folio",
  15. "description": "Save articles from any conversation and turn them into your own magazine: a PDF, a Kindle issue, or a printed copy by post.",
  16. "category": "productivity"
  17. }
  18. ]
  19. }
README.md · README · 254 lines
  1. <p align="center">
  2. <a href="https://weekendfolio.com">
  3. <img src="assets/banner.png" alt="Weekend Folio. Tell your assistant what you meant to read." width="100%" />
  4. </a>
  5. </p>
  6. <h3 align="center">Weekend Folio for AI assistants</h3>
  7. <p align="center">
  8. Save links from any conversation. Get them back as your own magazine:<br />
  9. a PDF, a Kindle issue, or a printed copy in the post.
  10. </p>
  11. <p align="center">
  12. <a href="https://weekendfolio.com"><img src="https://img.shields.io/badge/site-weekendfolio.com-161614?style=flat-square&labelColor=d9d6ce" alt="weekendfolio.com" /></a>
  13. <img src="https://img.shields.io/badge/connector-MCP_with_OAuth-161614?style=flat-square&labelColor=d9d6ce" alt="An MCP connector with OAuth" />
  14. <img src="https://img.shields.io/badge/skills-3-161614?style=flat-square&labelColor=d9d6ce" alt="Three skills" />
  15. <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-161614?style=flat-square&labelColor=d9d6ce" alt="MIT license" /></a>
  16. <a href="https://github.com/davidmokos/weekend-folio-plugin/actions/workflows/check.yml"><img src="https://img.shields.io/github/actions/workflow/status/davidmokos/weekend-folio-plugin/check.yml?branch=main&style=flat-square&label=check&labelColor=d9d6ce&color=161614" alt="The check of the manifests and skills" /></a>
  17. </p>
  18. ## What it is
  19. [Weekend Folio](https://weekendfolio.com) turns the articles you save into a magazine with your name on it. This repository is the plugin that connects it to an AI assistant. The plugin has two parts:
  20. - **A connector.** One MCP server at `https://weekendfolio.com/mcp`. It gives the assistant 13 tools for your reading list, your issues and your settings. You sign in with your Weekend Folio account. There is no API key.
  21. - **Three skills.** Short instructions that teach the assistant the work: how to save links, how to make an issue, and how to order a printed copy without a mistake.
  22. A conversation can go like this:
  23. > **You:** Save these three for the weekend. *(three links)*
  24. >
  25. > **Assistant:** Saved. 3 articles, 41 minutes of reading. 9 articles wait for your next issue.
  26. >
  27. > **You:** Make the issue in the Poster design and send it to my Kindle.
  28. >
  29. > **Assistant:** Issue No. 13 is ready: 9 articles, about 2 hours of reading. It is on its way to your Kindle.
  30. >
  31. > **You:** What does a printed copy cost?
  32. >
  33. > **Assistant:** 52 pages, sent to Prague. There are two shipping options, each with its total. Which one do you want?
  34. The numbers above are an example. The assistant takes the real ones from your library.
  35. ## Install
  36. Each assistant gets the connector. Some also load the skills.
  37. | Assistant | You get | How |
  38. | --- | --- | --- |
  39. | [Claude Code](#claude-code) | Connector and skills | Plugin |
  40. | [Claude](#claude) (web, desktop, mobile) | Connector | Custom connector |
  41. | [ChatGPT](#chatgpt) | Connector | Custom MCP server |
  42. | [Codex](#codex) | Connector and skills | Plugin |
  43. | [Cursor](#cursor) | Connector | Install link |
  44. | [Grok](#grok) | Connector, and skills in Grok Build | Custom connector or plugin |
  45. | [Gemini CLI](#gemini-cli) | Connector | Extension |
  46. | [VS Code and GitHub Copilot](#vs-code-and-github-copilot) | Connector, and skills in Copilot CLI | Install link or plugin |
  47. | [Other assistants](#other-assistants) | Connector | The address |
  48. The first time the assistant uses a tool, it sends you to weekendfolio.com to sign in and to allow the connection.
  49. ### Claude Code
  50. ```text
  51. /plugin install weekend-folio --marketplace davidmokos/weekend-folio-plugin
  52. ```
  53. Then run `/mcp`, select `weekend-folio`, and sign in.
  54. Before Claude Code 2.1.275, use two steps: `/plugin marketplace add davidmokos/weekend-folio-plugin`, then `/plugin install weekend-folio@weekend-folio`.
  55. ### Claude
  56. Open **Customize**, then **Connectors**. Select **Add**, then **Add custom connector**. Paste `https://weekendfolio.com/mcp`.
  57. On a Team or Enterprise plan, an owner adds the connector first, in the organization settings. Claude has [the steps](https://claude.com/docs/connectors/custom/remote-mcp).
  58. ### ChatGPT
  59. Open [chatgpt.com/plugins](https://chatgpt.com/plugins), select the plus button, then **Add custom MCP server**. Paste `https://weekendfolio.com/mcp`.
  60. ### Codex
  61. ```text
  62. codex plugin marketplace add davidmokos/weekend-folio-plugin
  63. codex plugin add weekend-folio@weekend-folio
  64. ```
  65. ### Cursor
  66. **[Add Weekend Folio to Cursor](https://cursor.com/link/mcp/install?name=weekend-folio&config=eyJ1cmwiOiJodHRwczovL3dlZWtlbmRmb2xpby5jb20vbWNwIn0%3D)**
  67. To add the skills too, see [Skills only](#skills-only).
  68. ### Grok
  69. - **Grok** (grok.com): open **Connectors**, select **New Connector**, then **Custom**. Paste `https://weekendfolio.com/mcp`.
  70. - **Grok Bot**: select **Add a custom connector**, type **Remote HTTPS**. Paste `https://weekendfolio.com/mcp` as the server URL.
  71. - **Grok Build**:
  72. ```text
  73. grok plugin marketplace add davidmokos/weekend-folio-plugin
  74. grok plugin install weekend-folio --trust
  75. ```
  76. ### Gemini CLI
  77. ```text
  78. gemini extensions install https://github.com/davidmokos/weekend-folio-plugin
  79. ```
  80. Then run `/mcp auth weekend-folio` in Gemini CLI to sign in.
  81. ### VS Code and GitHub Copilot
  82. - **VS Code**: [install the connector](https://vscode.dev/redirect?url=vscode%3Amcp%2Finstall%3F%257B%2522name%2522%253A%2522weekend-folio%2522%252C%2522type%2522%253A%2522http%2522%252C%2522url%2522%253A%2522https%253A%252F%252Fweekendfolio.com%252Fmcp%2522%257D).
  83. - **Copilot CLI**:
  84. ```text
  85. copilot plugin install davidmokos/weekend-folio-plugin:plugins/weekend-folio
  86. ```
  87. ### Other assistants
  88. Add a remote MCP server with this address. The assistant finds the sign-in from there.
  89. ```json
  90. {
  91. "mcpServers": {
  92. "weekend-folio": {
  93. "type": "http",
  94. "url": "https://weekendfolio.com/mcp"
  95. }
  96. }
  97. }
  98. ```
  99. | | |
  100. | --- | --- |
  101. | Transport | Streamable HTTP |
  102. | Sign-in | OAuth 2.1 with PKCE. The server answers `401` and points to its OAuth metadata. |
  103. | Client registration | Dynamic client registration, or a client ID metadata document |
  104. | Scopes | `library`, and `print` if the reader allows it |
  105. ### Skills only
  106. The [skills CLI](https://skills.sh/docs/cli) copies the three skills into the assistant that you select. The skills need the connector.
  107. ```text
  108. npx skills@latest add davidmokos/weekend-folio-plugin
  109. ```
  110. ## Try it
  111. - "Save this for the weekend: *(a link)*"
  112. - "What is waiting on my reading list?"
  113. - "Make an issue from the five longest articles and call it The Long Ones."
  114. - "Send my latest issue to my Kindle."
  115. - "What does it cost to print issue 12?"
  116. ## Sign-in and permissions
  117. You sign in on weekendfolio.com. The assistant does not see your password. On the same page you decide what the assistant can do:
  118. | Permission | What it lets the assistant do | Default |
  119. | --- | --- | --- |
  120. | Library | Read and change your reading list, your issues and your settings | Always on |
  121. | Print | Order printed copies, paid with your saved card | Off until you tick it |
  122. Without the print permission, the assistant can still get a quote. It then sends you a link, and you pay on the website.
  123. With the print permission, the assistant pays only after you say yes to one shipping option and its total.
  124. You can disconnect an assistant at any time in **Settings** on weekendfolio.com. A connection also ends by itself after 90 days without use.
  125. ## The tools
  126. | Tool | What it does | Changes data |
  127. | --- | --- | --- |
  128. | `save_links` | Saves links to your library | Yes |
  129. | `list_articles` | Lists your articles: up next, all, printed, failed or archived | No |
  130. | `get_article` | Gives the details of one article and the start of its text | No |
  131. | `update_articles` | Archives, restores or deletes articles | Yes |
  132. | `create_issue` | Makes a new issue from the articles that wait, or from the ones you name | Yes |
  133. | `list_issues` | Lists your issues | No |
  134. | `get_issue` | Gives the articles of one issue, in order | No |
  135. | `update_issue` | Changes the title, the design or the articles of an issue | Yes |
  136. | `deliver_issue` | Gives a PDF link, sends the issue to your Kindle, or gets a print quote | Yes |
  137. | `pay_for_print` | Pays for a printed copy with your saved card. Only with the print permission. | Yes |
  138. | `get_account` | Gives your settings | No |
  139. | `kindle_setup` | Gives the steps to connect a Kindle | No |
  140. | `update_account` | Changes your name, your default design or your Kindle address | Yes |
  141. ## The skills
  142. | Skill | Use |
  143. | --- | --- |
  144. | [`weekend-folio`](plugins/weekend-folio/skills/weekend-folio/SKILL.md) | Save links and look after the reading list |
  145. | [`weekend-folio-issue`](plugins/weekend-folio/skills/weekend-folio-issue/SKILL.md) | Make an issue, change it, and get it as a PDF or on a Kindle |
  146. | [`weekend-folio-print`](plugins/weekend-folio/skills/weekend-folio-print/SKILL.md) | Get a print quote and order a printed copy, with a confirmation before each payment |
  147. An issue comes in one of six designs: Folio, Feature, Poster, Margin, Still and Grid. The banner above shows the covers of three of them.
  148. ## What the plugin runs, sends and gets
  149. - **It runs nothing on your computer.** The plugin has no scripts, no hooks and no programs. It is a set of manifests and three text files.
  150. - **It talks to one address:** `https://weekendfolio.com`, for the tools and for the sign-in.
  151. - **It sends** what the assistant puts in a tool call: the links that you ask it to save, the articles and issues that you name, and the settings that you change.
  152. - **It gets** data from your own library: titles, sites, reading times, the start of an article's text, your issues, print quotes, and links to your PDF and EPUB files.
  153. Weekend Folio has a [privacy policy](https://weekendfolio.com/privacy) and [terms](https://weekendfolio.com/terms). Your assistant has its own.
  154. This repository is the plugin: the manifests, the skills and the documents. The Weekend Folio service is not in this repository.
  155. ## What is in the repository
  156. ```text
  157. plugins/weekend-folio/ The plugin that assistants install
  158. plugin.json Manifest: Agent Plugins format (ChatGPT, Codex, Cursor, Grok Build, Copilot)
  159. mcp.json The connector, in the Agent Plugins format
  160. .claude-plugin/plugin.json Manifest for Claude Code
  161. .mcp.json The connector, for Claude Code
  162. .cursor-plugin/plugin.json Manifest for the Cursor Marketplace
  163. skills/ The three skills
  164. assets/ The logo
  165. .claude-plugin/ Catalog for Claude Code, Grok Build and Copilot CLI
  166. .agents/plugins/ Catalog for Codex
  167. .cursor-plugin/ Catalog for Cursor
  168. gemini-extension.json Extension manifest for Gemini CLI
  169. server.json Entry for the MCP Registry
  170. docs/publishing.md How to submit the plugin to each directory
  171. scripts/check.mjs Checks that all of the above agree
  172. ```
  173. ## Directories
  174. Weekend Folio is not in a public plugin directory yet. [docs/publishing.md](docs/publishing.md) has the steps and the status for each directory.
  175. ## Contribute
  176. A better skill, a manifest for one more assistant, a correction: all are welcome. Read [CONTRIBUTING.md](CONTRIBUTING.md) first. Before you open a pull request, run:
  177. ```text
  178. node scripts/check.mjs
  179. ```
  180. ## Support
  181. For your account, your issues or an order, write to [hello@weekendfolio.com](mailto:hello@weekendfolio.com). The [support page](https://weekendfolio.com/support) answers the usual questions. For a problem with the plugin, [open an issue](https://github.com/davidmokos/weekend-folio-plugin/issues). [SUPPORT.md](SUPPORT.md) has the details. To report a security problem, see [SECURITY.md](SECURITY.md).
  182. ## License
  183. [MIT](LICENSE)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.