How do I use mcp-ploomes?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@mcp-ploomes List all contacts created this month" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

mcp-ploomes

by by-BC

Overview Schema Related Servers Score Discussions

Python

Hybrid

Ploomes MCP Server — Read-Only

Servidor MCP (Model Context Protocol) que expõe somente operações de leitura (GET) da API do CRM Ploomes.

⚠️ Este servidor não possui permissão para alterar, incluir ou excluir dados. Todas as 49 ferramentas disponíveis são exclusivamente de consulta.

Pré-requisitos

Python 3.11+
Uma conta Ploomes com User-Key de API

Related MCP server: Pipedrive MCP Server

Instalação

# Clone o repositório
git clone <url-do-repo>
cd ploomes-mcp-server

# Crie e ative um ambiente virtual (recomendado)
python -m venv .venv
.venv\Scripts\activate   # Windows
# source .venv/bin/activate  # Linux/Mac

# Instale as dependências
pip install -r requirements.txt

Configuração

Edite o arquivo .env na raiz do projeto:

# Chave de API do Ploomes (obrigatória)
PLOOMES_USER_KEY=sua-chave-aqui

# URL base da API (padrão: https://api2.ploomes.com)
PLOOMES_BASE_URL=https://api2.ploomes.com

# Limite de requisições simultâneas (padrão: 120)
PLOOMES_RATE_LIMIT=120

# Transporte MCP: stdio (padrão) ou http
MCP_TRANSPORT=stdio

# Porta para transporte HTTP (padrão: 3000)
MCP_HTTP_PORT=3000

Uso

Modo stdio (padrão — para Claude Desktop, Cursor, etc.)

python -m src.server

Modo HTTP

set MCP_TRANSPORT=http
python -m src.server

MCP Inspector (para desenvolvimento)

mcp dev src/server.py

Documentação Completa

🛠️ Guia de Configuração e Uso (docs/setup_guide.md): Passo a passo completo para configurar e usar no Claude Desktop, Antigravity IDE e Cursor, além de dicas de resolução de problemas.
📖 Guia Completo das Ferramentas (docs/tools_guide.md): Explicação detalhada de cada uma das 49 ferramentas, campos retornados, filtros OData e exemplos de prompts em linguagem natural.

Configuração Rápida

Claude Desktop

Adicione ao %APPDATA%\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "ploomes-reader": {
      "command": "C:\\caminho\\para\\ploomes-mcp-server\\.venv\\Scripts\\python.exe",
      "args": ["-m", "src.server"],
      "cwd": "C:\\caminho\\para\\ploomes-mcp-server"
    }
  }
}

Cursor

Adicione ao .cursor/mcp.json:

{
  "mcpServers": {
    "ploomes-reader": {
      "command": "C:\\caminho\\para\\ploomes-mcp-server\\.venv\\Scripts\\python.exe",
      "args": ["-m", "src.server"],
      "cwd": "C:\\caminho\\para\\ploomes-mcp-server"
    }
  }
}

Antigravity IDE

Adicione às configurações de MCP (mcp.json):

{
  "mcpServers": {
    "ploomes-reader": {
      "command": "C:\\caminho\\para\\ploomes-mcp-server\\.venv\\Scripts\\python.exe",
      "args": ["-m", "src.server"],
      "cwd": "C:\\caminho\\para\\ploomes-mcp-server"
    }
  }
}

Tools Disponíveis (49)

#	Tool	Endpoint	Descrição
1	`get_account`	/Account	Informações da conta/empresa
2	`get_cities`	/Cities	Cidades
3	`get_countries`	/Cities/Countries	Países
4	`get_states`	/Cities/Countries/States	Estados
5	`get_contacts`	/Contacts	Clientes/contatos
6	`get_contacts_numbers_of_employees`	/Contacts/NumbersOfEmployees	Opções de nº funcionários
7	`get_contacts_origins`	/Contacts/Origins	Origens de clientes
8	`get_contacts_lines_of_business`	/Contacts/LinesOfBusiness	Linhas de negócio
9	`get_contacts_relationships`	/Contacts/Relationships	Tipos de relacionamento
10	`get_contacts_status`	/Contacts/Status	Status de clientes
11	`get_contacts_types`	/Contacts/Types	Tipos de clientes
12	`get_contacts_products`	/Contacts/Products	Produtos de clientes
13	`get_currencies`	/Currencies	Moedas
14	`get_deals`	/Deals	Negócios
15	`get_deals_stages`	/Deals/Stages	Etapas dos negócios
16	`get_deals_status`	/Deals/Status	Status dos negócios
17	`get_deals_loss_reasons`	/Deals/LossReasons	Motivos de perda
18	`get_deals_pipelines`	/Deals/Pipelines	Funis de negócios
19	`get_documents`	/Documents	Documentos
20	`get_document_templates`	/DocumentTemplates	Modelos de documentos
21	`get_departments`	/Departments	Departamentos
22	`get_fields`	/Fields	Campos (inclui customizados)
23	`get_fields_entities`	/Fields/Entities	Entidades do sistema
24	`get_fields_options_tables`	/Fields/OptionsTables	Tabelas de opções
25	`get_fields_options_tables_options`	/Fields/OptionsTables/Options	Opções das tabelas
26	`get_fields_types`	/Fields/Types	Tipos de campos
27	`get_interaction_records`	/InteractionRecords	Registros de interação
28	`get_operations`	/Operations	Operações
29	`get_orders`	/Orders	Vendas
30	`get_orders_stages`	/Orders/Stages	Etapas das vendas
31	`get_phone_types`	/PhoneTypes	Tipos de telefone
32	`get_products`	/Products	Produtos
33	`get_products_families`	/Products/Families	Famílias de produtos
34	`get_products_groups`	/Products/Groups	Grupos de produtos
35	`get_products_parts`	/Products/Parts	Partes de produtos
36	`get_quotes`	/Quotes	Propostas
37	`get_quotes_approval_status`	/Quotes/ApprovalStatus	Status de aprovação
38	`get_relative_dates`	/RelativeDates	Datas relativas
39	`get_roles`	/Roles	Cargos
40	`get_tags`	/Tags	Marcadores
41	`get_tasks`	/Tasks	Tarefas
42	`get_task_types`	/Tasks/Types	Tipos de tarefas
43	`get_task_repeat_interval_units`	/Tasks/RepeatIntervalUnits	Intervalos de repetição
44	`get_task_email_reminders`	/Tasks/EmailReminders	Lembretes de email
45	`get_teams`	/Teams	Equipes
46	`get_users`	/Users	Usuários
47	`get_user_profiles`	/Users/Profiles	Perfis de usuários
48	`get_webhooks`	/Webhooks	Webhooks
49	`get_webhook_actions`	/Webhooks/Actions	Ações de webhooks

Exemplos de Uso (via LLM)

"Liste os 10 primeiros contatos com nome e email"
→ get_contacts(top=10, select="Id,Name,Email")

"Quais são os negócios acima de R$ 50.000?"
→ get_deals(filter="Amount gt 50000")

"Mostre os funis de negócios com suas etapas"
→ get_deals_pipelines(expand="Stages")

Licença

MIT

This server cannot be installed

RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

Maintenance

ActivityMaintained

ResponsivenessSyncing

Resources

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

mcp-server A
ar.com.muovi
Read-only MCP server for Muovi, Argentina's trust-first local services marketplace (6 tools).
E-commerce & Retail
621
HubSpot
com.hubspot.app
The HubSpot MCP Server acts as a bridge that enables AI assistants and Large Language Models to securely interact with HubSpot CRM data through natural conversation, without requiring users to understand complex API structures. It provides read-only access to standard CRM objects (contacts, companies, deals, tickets, products, invoices, and more) and their associations, secured via OAuth 2.0, allowing AI agents to perform tasks like summarizing deals, fetching company updates, and looking up record changes.
Customer Data Platforms Databases Marketing
3
Plixana
com.plixana
Operate the Plixana CRM from any AI: contacts, deals, quotes, WhatsApp and metrics.
CRM Communication
2
Relm CRM A
com.relmcrm
API-first CRM for LLMs - contacts, companies, deals and activities over a native MCP server.
CRM AI & Machine Learning
412

Related MCP Servers

Ploomes MCP Server
CRM Project Management
victorbenazzi
A
license
A
quality
D
maintenance
Connects AI agents to the Ploomes CRM REST API, exposing 56 tools for managing contacts, deals, tasks, pipelines, interactions, quotes, orders, products, fields, users, and account information.
Updated 4 months ago (2026-04-20 18:14 UTC)
56
19
1
MIT
Pipedrive MCP Server
CRM Search
WillDent
A
license
B
quality
A
maintenance
Enables read-only access to Pipedrive data including deals, persons, organizations, and pipelines, allowing LLMs like Claude to query and analyze CRM information through natural language.
Updated a month ago (2026-07-21 04:19 UTC)
16
2,470
60
MIT
pipedrive-pj
CRM Databases
hguareromanoo
F
license
Not graded
quality
D
maintenance
Read-only MCP server that exposes the Poli Júnior Pipedrive CRM to Claude as composable tools.
Updated 3 months ago (2026-06-12 02:44 UTC)
Ploomes MCP Server
CRM App Automation
JoseAlmeida-Ploomes
F
license
C
quality
C
maintenance
Exposes 153 tools to connect AI assistants to the Ploomes CRM, enabling CRUD operations, funnel configuration, CPQ, automations, and webhooks.
Updated a month ago (2026-07-30 20:35 UTC)
100
1

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/by-BC/mcp-ploomes'

If you have feedback or need assistance with the MCP directory API, please join our Discord server