What is Mcp Pocket

mcp-pocket is a Model Context Protocol (MCP) Server that connects to the Pocket API, allowing users to retrieve their saved articles and load them into Claude.

Use cases

Use cases for mcp-pocket include retrieving articles for reading, managing saved content efficiently, and integrating Pocket with Claude for enhanced productivity.

How to use

To use mcp-pocket, install Node.js and Claude Desktop, then configure Claude Desktop by modifying the ‘claude_desktop_config.json’ file to include your Pocket API credentials. You can fetch saved articles and mark them as read using the provided MCP commands.

Key features

Key features include fetching saved articles from the Pocket API, marking articles as read, and easy integration with Claude Desktop through a simple configuration.

Where to use

undefined

MCP Pocket

This is a connector to allow Claude Desktop (or any MCP client) to fetch your saved articles from Pocket API.

Prerequisites

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

Quick Start

1. Modify your Claude Desktop config located here:
   ~/Library/Application\ Support/Claude/claude_desktop_config.json

You can easily find this through the Claude Desktop menu:

1. Open Claude Desktop
2. Click Claude on the Mac menu bar
3. Click “Settings”
4. Click “Developer”

If you don’t have this config, you can create an empty file at this location.

Add the following to the config file, replacing the credentials with your own:

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

Development 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 this configuration instead:

{
  "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

# Watch mode for development
npm run watch

# Publish to npm
npm login
npm publish

Available Commands

The following MCP tools will be available in Claude Desktop:

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

Getting Pocket API Credentials

For detailed instructions on obtaining your Pocket API credentials, please refer to Issue #2.

Quick steps:

1. Create a new app at Pocket Developer Portal
2. Follow the authentication process to get your Consumer Key and Access Token

License

MIT