https://github.com/kazuph/mcp-pocket
🔗 Model Context Protocol (MCP) Server for retrieving saved articles from Pocket API and loading them into Claude
https://github.com/kazuph/mcp-pocket
Last synced: 4 months ago
JSON representation
🔗 Model Context Protocol (MCP) Server for retrieving saved articles from Pocket API and loading them into Claude
- Host: GitHub
- URL: https://github.com/kazuph/mcp-pocket
- Owner: kazuph
- License: mit
- Created: 2024-12-05T06:24:40.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2025-01-01T14:46:36.000Z (6 months ago)
- Last Synced: 2025-02-02T04:33:09.885Z (5 months ago)
- Language: JavaScript
- Homepage:
- Size: 19.5 KB
- Stars: 4
- Watchers: 1
- Forks: 3
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- mcp-index - Pocket Connector - Fetch and manage saved articles from the Pocket API to streamline access within the Claude Desktop interface. (Task and Project Management)
README
# 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:
```json
{
"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:
```bash
git clone https://github.com/kazuph/mcp-pocket.git
cd mcp-pocket
npm install
```
2. For development, use this configuration instead:
```json
{
"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
```bash
# 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](https://github.com/kazuph/mcp-pocket/issues/2).
Quick steps:
1. Create a new app at [Pocket Developer Portal](https://getpocket.com/developer/apps/new)
2. Follow the authentication process to get your Consumer Key and Access Token
## License
MIT