powerautomate-mcp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Joseph Ayala
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,228 @@
+# Power Automate MCP Server
+
+An MCP (Model Context Protocol) server that connects Claude to Microsoft Power Automate. Create, manage, and deploy Power Automate flows using natural language.
+
+## Features
+
+- **Create Flows** - Build flows from natural language descriptions with guided wizard
+- **Test & Debug** - Automatic testing with intelligent error diagnosis
+- **Validate** - Pre-flight checks with best practices scoring (0-100)
+- **Manage Flows** - List, update, clone, and delete flows
+- **Expression Help** - Interactive Power Automate expression reference
+- **Connector Intelligence** - Full knowledge of 400+ connectors and schemas
+- **Cross-Platform** - Works on Windows, macOS, and Linux
+
+## Quick Start
+
+### Prerequisites
+
+- Node.js 20+
+- Microsoft 365 work account with Power Automate access
+- **Linux only**: libsecret for secure token storage
+  ```bash
+  # Ubuntu/Debian
+  sudo apt-get install libsecret-1-dev gnome-keyring
+
+  # Fedora/RHEL
+  sudo dnf install libsecret-devel gnome-keyring
+  ```
+
+### Installation
+
+```bash
+npm install -g powerautomate-mcp
+```
+
+### First-Time Setup
+
+```bash
+powerautomate-mcp --setup
+```
+
+This interactive wizard will:
+1. Sign you in via browser
+2. Discover your Power Automate environments
+3. Create the configuration file
+
+### Register with Claude
+
+Add to your Claude configuration:
+
+**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
+**Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
+**Linux**: `~/.config/Claude/claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "powerautomate": {
+      "command": "powerautomate-mcp"
+    }
+  }
+}
+```
+
+Restart Claude. The Power Automate tools will appear automatically.
+
+## Usage Examples
+
+```
+Create a flow that sends me an email every morning with the weather forecast
+```
+
+```
+Test my "Daily Report" flow and tell me if there are any errors
+```
+
+```
+What connectors are available for working with SharePoint?
+```
+
+```
+Help me write an expression to format a date as "January 1, 2024"
+```
+
+## Available Tools
+
+### Core Flow Operations
+| Tool | Description |
+|------|-------------|
+| `list_flows` | List flows in an environment |
+| `get_flow` | Get full flow definition |
+| `create_flow` | Create a new flow |
+| `update_flow` | Modify an existing flow |
+| `delete_flow` | Delete a flow |
+| `toggle_flow` | Enable or disable a flow |
+| `clone_flow` | Copy flow to another environment |
+
+### Testing & Debugging
+| Tool | Description |
+|------|-------------|
+| `test_flow` | Run flow with automatic diagnosis |
+| `run_flow` | Trigger a manual flow |
+| `get_runs` | Get flow run history |
+| `diagnose_flow` | Analyze failures with fix suggestions |
+| `validate_flow` | Validate with best practices score |
+
+### Planning & Help
+| Tool | Description |
+|------|-------------|
+| `plan_flow` | Interactive flow planning wizard |
+| `build_flow` | Simple flow builder from description |
+| `get_expression_help` | Expression syntax reference |
+| `search_connectors` | Find connectors by name |
+| `get_action_schema` | Get connector action parameters |
+
+## Azure AD App Registration (Required)
+
+Before using this MCP server, an Azure AD app registration must be configured in your tenant. This requires **Global Administrator** or **Application Administrator** role.
+
+### Who Needs to Do This?
+
+| Role | Action Required |
+|------|-----------------|
+| IT Admin / Global Admin | Create app registration, grant admin consent |
+| End Users | Just run `powerautomate-mcp --setup` after admin completes setup |
+
+### Option 1: PowerShell Script (Recommended)
+
+```powershell
+# Requires: Azure CLI (https://aka.ms/installazurecli)
+# Requires: Global Admin or Application Administrator role
+
+az login
+./scripts/Register-PublishedApp.ps1
+```
+
+The script will:
+1. Create the app registration
+2. Configure required permissions
+3. Output the admin consent URL
+
+### Option 2: Manual Setup
+
+1. Go to [Azure Portal](https://portal.azure.com) > **Microsoft Entra ID** > **App registrations** > **New registration**
+
+2. Configure basic settings:
+   - **Name**: `Power Automate MCP`
+   - **Supported account types**: Accounts in any organizational directory (multi-tenant)
+   - **Redirect URI**: Select "Public client/native" and enter:
+     ```
+     https://login.microsoftonline.com/common/oauth2/nativeclient
+     ```
+
+3. After creation, go to **Authentication** and enable:
+   - **Allow public client flows**: Yes
+
+4. Go to **API permissions** > **Add a permission** and add:
+
+   | API | Permission | Type |
+   |-----|------------|------|
+   | Microsoft Graph | `User.Read` | Delegated |
+   | Power Automate (Flow Service) | `Flows.Read.All` | Delegated |
+   | Power Automate (Flow Service) | `Flows.Manage.All` | Delegated |
+
+5. Click **Grant admin consent for [Your Tenant]** (requires admin role)
+
+### Admin Consent
+
+After creating the app, admin consent is required for users to authenticate:
+
+```
+https://login.microsoftonline.com/common/adminconsent?client_id=YOUR_CLIENT_ID
+```
+
+Replace `YOUR_CLIENT_ID` with the Application (client) ID from your app registration.
+
+### Update the MCP Server
+
+After creating your app registration, update `src/setup/published-app.ts` with your client ID and rebuild:
+
+```bash
+npm run build
+```
+
+## Security
+
+This server implements security best practices:
+
+- **Secure Token Storage**: DPAPI (Windows), Keychain (macOS), libsecret (Linux)
+- **Input Validation**: OData injection protection, query sanitization
+- **Error Sanitization**: PII redacted from logs and error messages
+- **No Plaintext Secrets**: Tokens never stored in plaintext
+
+## Development
+
+```bash
+# Clone and install
+git clone https://github.com/rcb0727/powerautomate-mcp.git
+cd powerautomate-mcp
+npm install
+
+# Build
+npm run build
+
+# Build in watch mode
+npm run dev
+
+# Test with MCP Inspector
+npm run inspect
+```
+
+## Architecture
+
+```
+Claude <--stdio--> powerautomate-mcp <--REST--> Power Automate APIs
+                          |
+                          ├── MSAL Auth (browser popup / device code)
+                          ├── SQLite Schema Cache (400+ connectors)
+                          └── Secure Token Storage (OS keychain)
+```
+
+## License
+
+MIT
+
+## Contributing
+
+PRs welcome! See [CLAUDE.md](./CLAUDE.md) for development workflow.

package/dist/index.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node