# Pinlyx

MCP server that connects Claude Code, Cursor and other clients to Pinlyx CRM: contacts, deals, DMs from Instagram, Facebook, X, LinkedIn and eight more platforms, post scheduler, mailboxes and Google Ads.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 6 repo stars
- Author: Pinlyx
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Pinlyx/pinlyx-mcp
- Updated: 2026-09-24
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/pinlyx

## What it does

The server exposes 142 tools from the Pinlyx CRM panel. Thirteen handle social media: seven read and reply to DMs from a unified inbox (Instagram, Facebook, X, LinkedIn, TikTok, YouTube, Threads, Pinterest, Reddit, Bluesky, Telegram, WhatsApp), six schedule posts in the calendar and pull publishing stats. The remaining 129 manage contacts, tasks, deals, pipelines, email threads, finance and Google Ads campaigns. Changes the agent makes through the server show up immediately in the Pinlyx web panel, and vice versa.

Requires a Pinlyx API key from account settings (`csk_live_...`). The server runs via `npx` without installing the package in advance: `npx -y @crmsolid/mcp-server` downloads it on first call. Supports two transports — stdio and HTTP (`https://api.pinlyx.com/mcp`). The `CRMSOLID_READ_ONLY` variable blocks writes, `CRMSOLID_TOOLS` restricts the available tool set.

\`crm_schedule_social_post` requires a time in `scheduledAt` or the flag `publishNow: true` — without one of these parameters the call is rejected, so a post cannot publish by accident. `crm_add_email_account` connects a mailbox over IMAP/SMTP: it takes an address and an app password, tests both connections and saves settings only after successful authentication, never returning the password.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://api.pinlyx.com/mcp`
- Environment variables: `CRMSOLID_API_KEY`, `CRMSOLID_BASE_URL`, `CRMSOLID_READ_ONLY`, `CRMSOLID_TOOLS` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI**
```bash
claude mcp add --env CRMSOLID_API_KEY=<CRMSOLID_API_KEY> --env CRMSOLID_BASE_URL=<CRMSOLID_BASE_URL> --env CRMSOLID_READ_ONLY=<CRMSOLID_READ_ONLY> --env CRMSOLID_TOOLS=<CRMSOLID_TOOLS> --transport stdio pinlyx -- npx -y @crmsolid/mcp-server
```
Replace <…> with your own values

2. **Platform CLI: remote server**
```bash
claude mcp add --transport http pinlyx https://api.pinlyx.com/mcp
```

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add pinlyx --url https://api.pinlyx.com/mcp
```

2. **Platform CLI**
```bash
codex mcp add pinlyx --env CRMSOLID_API_KEY=<CRMSOLID_API_KEY> --env CRMSOLID_BASE_URL=<CRMSOLID_BASE_URL> --env CRMSOLID_READ_ONLY=<CRMSOLID_READ_ONLY> --env CRMSOLID_TOOLS=<CRMSOLID_TOOLS> -- npx -y @crmsolid/mcp-server
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "pinlyx": {
            "url": "https://api.pinlyx.com/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "pinlyx": {
            "command": "npx",
            "args": [
                "-y",
                "@crmsolid/mcp-server"
            ],
            "env": {
                "CRMSOLID_API_KEY": "<CRMSOLID_API_KEY>",
                "CRMSOLID_BASE_URL": "<CRMSOLID_BASE_URL>",
                "CRMSOLID_READ_ONLY": "<CRMSOLID_READ_ONLY>",
                "CRMSOLID_TOOLS": "<CRMSOLID_TOOLS>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "pinlyx": {
            "type": "http",
            "url": "https://api.pinlyx.com/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "pinlyx": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@crmsolid/mcp-server"
            ],
            "env": {
                "CRMSOLID_API_KEY": "<CRMSOLID_API_KEY>",
                "CRMSOLID_BASE_URL": "<CRMSOLID_BASE_URL>",
                "CRMSOLID_READ_ONLY": "<CRMSOLID_READ_ONLY>",
                "CRMSOLID_TOOLS": "<CRMSOLID_TOOLS>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http pinlyx https://api.pinlyx.com/mcp
```

2. **Platform CLI**
```bash
gemini mcp add -e CRMSOLID_API_KEY=<CRMSOLID_API_KEY> -e CRMSOLID_BASE_URL=<CRMSOLID_BASE_URL> -e CRMSOLID_READ_ONLY=<CRMSOLID_READ_ONLY> -e CRMSOLID_TOOLS=<CRMSOLID_TOOLS> pinlyx npx -y @crmsolid/mcp-server
```
Replace <…> with your own values

## When to use it
- triage DMs from Instagram, Facebook, X and ten other platforms in one inbox
- draft five posts for next week and show the table before publishing any
- move a post from Thursday to Friday at 09:00 in a specific time zone
- open a task for each mention of a refund and assign the contact
- compare post performance across two months

## Example prompts
- Show my social inbox and highlight conversations that have been waiting longest for a reply
- Schedule a LinkedIn post for Friday 09:00 Europe/Istanbul with text from `launch-notes.md`

## Similar
- [WoopSocial Social Media MCP](https://affpapa.org/en/nevibecode/mcp/woopsocial-social-media-mcp.md) — MCP server · ★ 2 repo stars
- [Chat33](https://affpapa.org/en/nevibecode/mcp/chat33.md) — MCP server
- [SocialRobot MCP Server](https://affpapa.org/en/nevibecode/mcp/socialrobot-mcp-server.md) — MCP server
- [socialclaw](https://affpapa.org/en/nevibecode/skills/socialclaw-socialclaw.md) — skill · ★ 112 repo stars
- [carousel-writer](https://affpapa.org/en/nevibecode/skills/carousel-writer.md) — skill · 1500 installs
- [ToFlow](https://affpapa.org/en/nevibecode/mcp/toflow.md) — MCP server · ★ 6 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
