npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

@planflow-tools/mcp

v0.2.2

Published

PlanFlow MCP Server for Claude Code - AI-native project management from your terminal

Vulnerabilities

Powered byPowered by Snyk
  • 0High
  • 0Medium
  • 0Low

Links

Git

Maintainers

chkhirochkhiro

Keywords

mcpmodel-context-protocolclaudeclaude-codeanthropicaiproject-managementtask-managementdeveloper-toolscliplanflow

Readme

@planflow/mcp

MCP (Model Context Protocol) server for PlanFlow - AI-native project management from your terminal.

Overview

This package provides a MCP server that integrates PlanFlow with Claude Code, allowing you to manage projects and tasks directly from your AI-powered development workflow.

Quick Start

# 1. Install globally
npm install -g @planflow/mcp

# 2. Add to Claude Desktop config (~/.config/claude/claude_desktop_config.json)
{
  "mcpServers": {
    "planflow": {
      "command": "planflow-mcp"
    }
  }
}

# 3. Restart Claude Desktop

# 4. In Claude, login with your API token
"Login to PlanFlow with token pf_xxxxx"

Requires Node.js >= 20.0.0. See INSTALLATION.md for detailed setup instructions.

Installation

npm install -g @planflow/mcp

Or with pnpm:

pnpm add -g @planflow/mcp

Need help? See the complete installation guide for detailed instructions, troubleshooting, and configuration options.

Configuration

Add the MCP server to your Claude Code configuration file (~/.config/claude/claude_desktop_config.json):

{
  "mcpServers": {
    "planflow": {
      "command": "planflow-mcp"
    }
  }
}

Or if installed locally in a project:

{
  "mcpServers": {
    "planflow": {
      "command": "npx",
      "args": ["@planflow/mcp"]
    }
  }
}

Authentication

Before using PlanFlow tools, authenticate with your API token:

  1. Get your API token from planflow.tools/settings/api
  2. Use the planflow_login tool in Claude Code with your token

Available Tools

| Tool | Description | |------|-------------| | planflow_login | Authenticate with your PlanFlow API token | | planflow_logout | Clear stored credentials | | planflow_whoami | Show current authenticated user | | planflow_projects | List all your projects | | planflow_create | Create a new project | | planflow_sync | Sync local PROJECT_PLAN.md to cloud | | planflow_task_list | List tasks for a project | | planflow_task_update | Update task status | | planflow_task_next | Get next recommended task | | planflow_notifications | View your notifications |

Usage Examples

Login

Use planflow_login with my API token: pf_xxxxx

List Projects

Show me my PlanFlow projects

Sync Project Plan

Sync my PROJECT_PLAN.md to PlanFlow

Update Task Status

Mark task T1.5 as done in PlanFlow

Get Next Task

What should I work on next?

Environment Variables

| Variable | Description | Default | |----------|-------------|---------| | PLANFLOW_API_URL | API server URL | https://api.planflow.tools | | PLANFLOW_DEBUG | Enable debug logging | false |

Configuration Storage

Credentials are stored in ~/.config/planflow/config.json:

{
  "apiUrl": "https://api.planflow.tools",
  "token": "pf_...",
  "userId": "...",
  "email": "..."
}

Requirements

  • Node.js >= 20.0.0
  • Claude Code with MCP support

Development

# Install dependencies
pnpm install

# Run in development mode
pnpm dev

# Build for production
pnpm build

# Run tests
pnpm test

# Run tests with coverage
pnpm test:coverage

License

MIT - see LICENSE for details.

Links