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

license - permissive license

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

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 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
22
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 22 days ago (2026-07-21 04:19 UTC)
16
1,742
60
MIT
pipedrive-pj
CRM Databases
hguareromanoo
F
license
-
quality
C
maintenance
Read-only MCP server that exposes the Poli Júnior Pipedrive CRM to Claude as composable tools.
Updated 2 months ago (2026-06-12 02:44 UTC)
was-pipedrive-mcp
CRM Customer Data Platforms
mnsmasum62786
A
license
-
quality
C
maintenance
A self-contained MCP server for Pipedrive CRM that exposes 27 tools allowing AI coding assistants to read, create, update, search, and manage deals, contacts, activities, organizations, leads, and pipelines.
Updated 15 days ago (2026-07-28 11:06 UTC)
MIT

View all related MCP servers

Related MCP Connectors

mcp-server
Read-only MCP server for Muovi, Argentina's trust-first local services marketplace (6 tools).
classquill-mcp
Read-only MCP server for ClassQuill, a tutoring-business-management platform.
anchorr-mcp
Agent-native CRM. 25 tools — contacts, deals, sequences, enrichment waterfall, audit log.

View all MCP Connectors

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