pm-studio-mcp 0.4.0

PM Studio MCP Server - A Model Context Protocol server for product managers

PM Studio MCP

PM Studio MCP is a Model Context Protocol (MCP) server for product management tasks. It provides a suite of tools and utilities to help product managers analyze user feedback, perform competitive analysis, generate data visualizations, and access structured data sources.

Available Tools

Category & Description	Tools
🔍 Search & Web Google web search, website crawling	google_web_tool crawl_website_tool
📊 Data & Analytics Product insights, SQL querying, charts & visualizations	fetch_product_insights titan_query_data_tool titan_search_table_metadata_tool titan_generate_sql_from_template_tool generate_data_visualization
💼 M365 Graph Teams messaging, email, calendar integration	send_message_to_chat_tool send_message_to_channel_tool send_mail_tool get_calendar_events
🔧 Utilities Document conversion, greeting utility	convert_to_markdown_tool greeting_with_pm_studio

Quick Start

Prerequisites

• macOS: brew install uv (Install Homebrew first if needed)
• Windows: Download uv and ensure it's in your PATH

MCP Server Configuration

Add the following to MCP configuration file (setting.json in VS Code global setting, or mcp.json in your project):

{
  "mcpServers": {
    "pm-studio-mcp": {
      "command": "uvx",
      "args": ["pm-studio-mcp", "--python=python3.10"],
      "env": {
          "WORKING_PATH": "{YOUR_WORKSPACE_PATH}/working_dir/"
          // Add additional variables here, refer to Environment Settings below
      }
    }
  }
}

Development Mode (Local Source)

For local development, modify the configuration:

{
  "command": "uv",
  "args": ["--directory", "{PATH_TO_CLONED_REPO}/src/", "run", "-m", "pm_studio_mcp"]
}

Path Examples:

• macOS: /Users/username/Documents/pm-studio-mcp
• Windows: C:\\Users\\username\\Documents\\pm-studio-mcp

Environment Settings

Add these environment variables to the env section of your MCP configuration when needed.

Variable	Required	Description
WORKING_PATH	✅	A writable Directory where output files will be stored.
GRAPH_CLIENT_ID	❌	Microsoft Graph API authentication for Teams/Email/Calendar.
REDDIT_CLIENT_ID	❌	Reddit API access for Reddit data analysis tools.
REDDIT_CLIENT_SECRET	❌	Reddit API authentication. Must be paired with Reddit Client ID.
DATA_AI_API_KEY	❌	Access to Data.ai analytics for app store data and reviews.
UNWRAP_ACCESS_TOKEN	❌	Unwrap AI API access for sentiment analysis features.

Note: Only WORKING_PATH is required. Other variables can be added as needed for specific features.

Graph Client IDs

The PM Studio MCP automatically detects the appropriate Microsoft Graph Client ID for your team based on your user identity. The detection follows this priority order:

1. Environment variable: Uses the GRAPH_CLIENT_ID environment variable if provided
2. Auto-detection: Uses Azure CLI and Microsoft Graph API to identify your user alias and map it to your team's Graph Client ID
3. No Graph access: If neither method works, Graph-related tools will be unavailable

Team Mapping

The following teams have configured Graph Client IDs. If your alias is registered, it will be automatically detected:

Team/Service	Supported Users
Edge Consumer+ Tracy	yche, gajie, juanliu, mile, yancheng, dingxiao
Edge Mobile	emilywu, hongjunqiu, yingzhuang, lmike, yazhouzhou, shengjieshi, v-xiaomengli, wenyuansu, jinghuama
SA - Bill	tajie, xiaoxch, chenxitan, carmenwei, liyayong, yongweizhang
SA - Kelly + Jingwei	yugon, danliu, eviema, angliu, menghuihu, emmaxu, zhangjingwei
WebComFun	michachen, chfen, alexyuan, lingyanzhao, nanyin, siyangliu

Note: If your alias is not listed above, contact the maintainer to add it to the team mapping.

Manual Configuration

To set a specific client ID (takes highest priority), add it to the environment configuration:

"env": {
    "WORKING_PATH": "{YOUR_WORKSPACE_PATH}/working_dir/",
    "GRAPH_CLIENT_ID": "your-manual-client-id"
}

Troubleshooting

If Graph tools are not working:

1. Check if GRAPH_CLIENT_ID environment variable is set correctly
2. Verify you're logged into Azure CLI (az login) and have Graph API access
3. Check if your user alias is in the supported users list above
4. Contact the maintainer to add your alias to the appropriate team mapping