Skip to main content
Glama
@kazuph/mcp-pocket
by kazuph

Bolsillo MCP

Este es un conector que permite a Claude Desktop (o cualquier cliente MCP) recuperar sus artículos guardados desde Pocket API.

Prerrequisitos

  • Node.js (instalación mediante brew install node )

  • Claude Desktop (instalación desde https://claude.ai/desktop )

  • Credenciales de la API de bolsillo

Related MCP server: Notion MCP

Inicio rápido

  1. Modifique la configuración de Claude Desktop ubicada aquí: ~/Library/Application\ Support/Claude/claude_desktop_config.json

Puedes encontrarlo fácilmente a través del menú de Claude Desktop:

  1. Abra Claude Desktop

  2. Haga clic en Claude en la barra de menú de Mac

  3. Haga clic en "Configuración"

  4. Haga clic en "Desarrollador"

Si no tiene esta configuración, puede crear un archivo vacío en esta ubicación.

Agregue lo siguiente al archivo de configuración, reemplazando las credenciales con las suyas:

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

Configuración de desarrollo

  1. Clonar este repositorio e instalar las dependencias:

git clone https://github.com/kazuph/mcp-pocket.git
cd mcp-pocket
npm install
  1. Para el desarrollo, utilice esta configuración en su lugar:

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

Comandos de desarrollo

# Build TypeScript
npm run build

# Watch mode for development
npm run watch

# Publish to npm
npm login
npm publish

Comandos disponibles

Las siguientes herramientas MCP estarán disponibles en Claude Desktop:

  • pocket_get_articles : Obtiene tus artículos guardados de la API de Pocket. Devuelve el título, la URL y un extracto de cada artículo.

  • pocket_mark_as_read : marca un artículo específico como leído (archivado) en tu cuenta de Pocket usando su ID de artículo.

Obtención de credenciales de Pocket API

Para obtener instrucciones detalladas sobre cómo obtener sus credenciales de Pocket API, consulte el número 2 .

Pasos rápidos:

  1. Cree una nueva aplicación en Pocket Developer Portal

  2. Siga el proceso de autenticación para obtener su clave de consumidor y token de acceso

Licencia

Instituto Tecnológico de Massachusetts (MIT)

Available Tools

2 tools
pocket_get_articlesA

Fetches the latest unread articles from Pocket API. Returns up to 20 articles by default. You can specify the number of articles to fetch (1-20) using the count parameter. Returns the article ID, title, URL, and excerpt for each article.

Inputs: count.

pocket_mark_as_readA

Marks a specific Pocket article as read (archived) using its item ID.

Inputs: itemId (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.6/5.0

    Scored across 2 tools

    Disambiguation5/5

    The two tools have clearly distinct purposes: one fetches unread articles, while the other marks articles as read. There is no overlap in functionality, making it easy for an agent to select the correct tool based on the desired action.

    Naming Consistency5/5

    Both tools follow a consistent 'pocket_verb_noun' pattern, using snake_case and starting with the server domain prefix. This predictability aids in tool identification and usage.

    Tool Count2/5

    With only two tools, the server feels thin for a Pocket API integration. While it covers fetching and marking articles, it lacks operations like adding articles, managing tags, or retrieving read articles, which are core to the Pocket domain.

    Completeness2/5

    The toolset is severely incomplete for a Pocket API server. It misses essential operations such as adding articles to Pocket, retrieving read articles, managing tags, and deleting articles, leaving significant gaps that will hinder agent workflows.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers