mcpField
M
MCP Pocket

MCP Pocket

Local
github.com/kazuphProductivity9Updated 95w ago
Repository

About MCP Pocket

MCP Pocket connects Claude Desktop or another MCP client to Pocket, letting users retrieve saved articles and archive them as read.

Key features

  1. 01Fetch saved articles with title, URL, and excerpt
  2. 02Mark an article as read

Use cases

  1. 01Review saved articles in an MCP client
  2. 02Archive a Pocket article after reading

MCP support

Exposes tools to MCP clients for fetching Pocket articles and marking an article as read.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "pocket": {
      "command": "npx",
      "args": [
        "-y",
        "@kazuph/mcp-pocket"
      ],
      "env": {
        "POCKET_CONSUMER_KEY": "<POCKET_CONSUMER_KEY>",
        "POCKET_ACCESS_TOKEN": "<POCKET_ACCESS_TOKEN>"
      }
    }
  }
}
Run commandnpx -y @kazuph/mcp-pocket
Environment variables to set
POCKET_CONSUMER_KEYSecret
POCKET_ACCESS_TOKENSecret

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@kazuph/mcp-pocket

Tools

2

Saved tool list · updated 3w ago

ParameterTypeRequiredDescription
countnumberNo

Details

From the project README

MCP Pocket

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

@kazuph/mcp-pocket MCP server

Prerequisites

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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.