npm version Pica MCP Banner

​
What is MCP?

Model Context Protocol (MCP) is a system that lets AI apps, like Claude Desktop or Cursor, connect to external tools and data sources. It gives a clear and safe way for AI assistants to work with local services and APIs while keeping the user in control.
Want to learn more about Anthropic’s Model Control Protocol? Visit the website or read the docs.

NPM

Download the MCP Server from NPM and install it locally

Smithery

Install the MCP Server via Smithery

Glama

Install the MCP Server via Glama

​
Pica MCP Server

Pica MCP Server is a server that enables seamless interaction with various third-party services through a standardized interface. This server provides direct access to platform integrations, actions, execution capabilities, and robust code generation capabilities.

​
Tools

  • list_pica_integrations - List all available platforms and your active connections
  • get_pica_platform_actions - Get available actions for a specific platform
  • get_pica_action_knowledge - Get detailed documentation for a specific action including parameters and usage
  • execute_pica_action - Execute API actions with full parameter support

​
Installation

npm install @picahq/mcp

​
Setup

This server requires a Pica API key. Set the environment variable: 
export PICA_SECRET=your_pica_secret_key

​
Client Integration

​
Using Claude Desktop

To use with Claude Desktop, add the server config: On MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json On Windows: %APPDATA%/Claude/claude_desktop_config.json 
{
  "mcpServers": {
    "pica": {
      "command": "npx",
      "args": ["@picahq/mcp"],
      "env": {
        "PICA_SECRET": "your-pica-secret-key"
      }
    }
  }
}
Try asking Claude:
  • What connections do I have access to?
  • Send an email using gmail to hello@picaos.com
  • What actions can I perform with google sheets?
  • Create an event in my calendar
  • List 5 users from my postgres users table
  • Send a message in slack to the #general channel with today’s weather

​
Using Cursor

In the Cursor menu, select “MCP Settings” and update the MCP JSON file to include the following: 
{
  "mcpServers": {
    "pica": {
      "command": "npx",
      "args": ["@picahq/mcp"],
      "env": {
        "PICA_SECRET": "your-pica-secret-key"
      }
    }
  }
}

​
Using Docker

Build the Docker Image: 
docker build -t pica-mcp-server .
Run the Docker Container: 
docker run -e PICA_SECRET=your_pica_secret_key pica-mcp-server

​
Docker with Claude Desktop

To use the Docker container with Claude Desktop, update your claude_desktop_config.json with: 
{
  "mcpServers": {
    "pica-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e", "PICA_SECRET=YOUR_PICA_SECRET_KEY",
        "pica-mcp-server"
      ]
    }
  }
}

​
Manual Installation

Install dependencies: 
npm install
Build the server: 
npm run build
For development with auto-rebuild: 
npm run watch

​
Manual Claude Desktop Config

{
  "mcpServers": {
    "pica-mcp-server": {
      "command": "node",
      "args": [
        "/path/to/pica-mcp-server/build/index.js"
      ],
      "env": {
        "PICA_SECRET": "YOUR_PICA_SECRET_KEY"
      }
    }
  }
}

​
Deploy to Vercel

You can deploy this MCP server to Vercel for remote access:
  1. Install dependencies including Vercel adapter: 
    npm install @vercel/mcp-adapter zod
  2. Deploy to Vercel: 
    vercel
  3. Configure your MCP client to use the remote server:
    • For Cursor: https://your-project.vercel.app/api/mcp
    • For Claude/Cline: Use npx mcp-remote https://your-project.vercel.app/api/mcp

​
Examples for Inspiration

​
Integration Code Generation

Build Email Form

Create a React form component that can send emails using Gmail with Pica integration

Linear Dashboard

Build a dashboard to display Linear users and their assigned projects with filtering capabilities

QuickBooks Table

Create a paginatable table component for QuickBooks invoices with search and sort functionality

Slack Integration

Develop a form interface for posting scheduled messages to multiple Slack channels

​
Direct Action Execution

Read Gmail Emails

“Get my last 5 emails from Gmail using Pica”

Send Slack Message

“Send a slack message to #general channel: ‘Meeting in 10 minutes’ using Pica”

​
Demo