MCP Pocket

🚀 MCP Pocket English Guide

This is a connector that allows Claude Desktop (or other MCP clients) to retrieve your saved articles from the Pocket API.

🚀 Quick Start

Prerequisites

• Node.js (Install via brew install node)
• Claude Desktop (Download and install from https://claude.ai/desktop)
• Pocket API credentials

Steps

1. Modify your Claude Desktop configuration file located at:

   ~/Library/Application\ 支持/Claude/claude_desktop_config.json
   

   You can easily find this file by following these steps:

   1. Open Claude Desktop
   2. Click "Claude" in the menu bar
   3. Click "Settings"
   4. Click "Developer"

   If you don't have this configuration file, you can create an empty file at that location.

   Add the following content to the configuration file, replacing it with your own credentials:

   {
     "mcpServers": {
       "pocket": {
         "command": "npx",
         "args": ["-y", "@kazuph/mcp-pocket"],
         "env": {
           "POCKET_CONSUMER_KEY": "your-pocket-consumer-key",
           "POCKET_ACCESS_TOKEN": "your-pocket-access-token"
         }
       }
     }
   }
   

📦 Installation

Development Environment Setup

1. Clone this repository and install dependencies:

   git clone https://github.com/kazuph/mcp-pocket.git
   cd mcp-pocket
   npm install
   

2. For development, use the following configuration:

   {
     "mcpServers": {
       "pocket": {
         "command": "npx",
         "args": ["tsx", "/path/to/mcp-pocket/index.ts"],
         "env": {
           "POCKET_CONSUMER_KEY": "your-pocket-consumer-key",
           "POCKET_ACCESS_TOKEN": "your-pocket-access-token"
         }
       }
     }
   }
   

Development Commands

# Build TypeScript
npm run build

# Development mode (Live monitoring)
npm run watch

# Publish to npm
npm login
npm publish

💻 Usage Examples

Available Commands

In Claude Desktop, the following MCP tools will be available:

• pocket_get_articles: Retrieve your saved articles from the Pocket API. Returns the title, URL, and excerpt of each article.
• pocket_mark_as_read: Mark a specific article as read (archive) in your Pocket account using its item ID.

📚 Documentation

Obtaining Pocket API Credentials

For detailed instructions on how to obtain Pocket API credentials, please refer to Issue #2.

Brief steps:

1. Create a new application in the Pocket Developer Console
2. Follow the authentication process to obtain your consumer key and access token

📄 License

MIT