matimo-hubspot 0.1.0__tar.gz

matimo_hubspot-0.1.0/.gitignore

@@ -0,0 +1,63 @@
+# Dependencies
+**/node_modules/
+package-lock.json
+yarn.lock
+
+# Build output
+**/dist/
+*.tsbuildinfo
+
+# Python compiled / build
+**/__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+*.egg
+**/build/
+**/.eggs/
+**/.venv/
+**/.mypy_cache/
+**/.ruff_cache/
+**/.pytest_cache/
+
+# Test coverage
+**/coverage/
+**/.nyc_output/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+.DS_Store
+
+# Environment
+.env
+.env.local
+.env.*.local
+
+# Logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Temporary files
+tmp/
+temp/
+*.tmp
+typescript/examples/mcp/matimo-tools/.matimo-approvals.json
+typescript/examples/mcp/matimo-tools/fetch-weather/definition.yaml
+typescript/examples/mcp/matimo-tools/npm_downloads/definition.yaml
+typescript/examples/mcp/matimo-tools/skills/ecosystem-health/SKILL.md
+typescript/examples/mcp/matimo-tools/skills/matimo-health-check/SKILL.md
+typescript/examples/mcp/matimo-tools/skills/moltbook-identity/SKILL.md
+typescript/packages/cli/.matimo/certs/server.crt
+typescript/packages/cli/.matimo/certs/server.key
+typescript/examples/mcp/.matimo/certs/server.crt
+typescript/examples/mcp/.matimo/certs/server.key

matimo_hubspot-0.1.0/PKG-INFO

@@ -0,0 +1,156 @@
+Metadata-Version: 2.4
+Name: matimo-hubspot
+Version: 0.1.0
+Summary: Matimo provider — HubSpot CRM tools (contacts, deals, companies, tickets)
+License: MIT
+Keywords: agents,ai,hubspot,matimo,tools
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.11
+Requires-Python: >=3.11
+Requires-Dist: matimo-core<0.2.0,>=0.1.0
+Description-Content-Type: text/markdown
+
+# matimo-hubspot
+
+> HubSpot CRM tools for [Matimo](https://matimo.dev) — manage contacts, companies, deals, tickets, and more.
+
+[![PyPI](https://img.shields.io/pypi/v/matimo-hubspot)](https://pypi.org/project/matimo-hubspot/)
+[![Docs](https://img.shields.io/badge/docs-matimo.dev-blue)](https://matimo.dev/docs)
+
+---
+
+## Installation
+
+```bash
+pip install matimo matimo-hubspot
+```
+
+---
+
+## Available Tools (50 Total)
+
+Full CRUD coverage across 10 HubSpot object types:
+
+| Object | Create | Get | List | Update | Delete |
+|--------|:------:|:---:|:----:|:------:|:------:|
+| Contacts | ✅ | ✅ | ✅ | ✅ | ✅ |
+| Companies | ✅ | ✅ | ✅ | ✅ | ✅ |
+| Deals | ✅ | ✅ | ✅ | ✅ | ✅ |
+| Tickets | ✅ | ✅ | ✅ | ✅ | ✅ |
+| Leads | ✅ | ✅ | ✅ | ✅ | ✅ |
+| Products | ✅ | ✅ | ✅ | ✅ | ✅ |
+| Line Items | ✅ | ✅ | ✅ | ✅ | ✅ |
+| Orders | ✅ | ✅ | ✅ | ✅ | ✅ |
+| Invoices | ✅ | ✅ | ✅ | ✅ | ✅ |
+| Custom Objects | ✅ | ✅ | ✅ | ✅ | ✅ |
+
+### Tool naming convention: `hubspot-{verb}-{object}`
+
+Examples: `hubspot-create-contact`, `hubspot-list-deals`, `hubspot-update-ticket`, `hubspot-delete-company`
+
+---
+
+## Quick Start
+
+```python
+import asyncio
+import os
+from matimo import Matimo
+from matimo_hubspot import get_tools_path
+
+async def main():
+    matimo = await Matimo.init(get_tools_path())
+
+    # Create a contact
+    contact = await matimo.execute('hubspot-create-contact', {
+        'firstname': 'Jane',
+        'lastname': 'Smith',
+        'email': 'jane@example.com',
+        'company': 'Acme Corp',
+    })
+
+    # List all deals
+    deals = await matimo.execute('hubspot-list-deals', {
+        'limit': 20,
+    })
+
+    # Update a ticket
+    await matimo.execute('hubspot-update-ticket', {
+        'ticket_id': '12345',
+        'subject': 'Updated subject',
+        'hs_pipeline_stage': '4',
+    })
+
+asyncio.run(main())
+```
+
+---
+
+## Authentication
+
+```bash
+export HUBSPOT_ACCESS_TOKEN="pat-na1-your-private-app-token"
+```
+
+### Setting Up a HubSpot Private App
+
+1. In HubSpot, go to **Settings** → **Integrations** → **Private Apps**
+2. Click **Create a private app**
+3. Under **Scopes**, select the CRM scopes you need (see table below)
+4. Copy the **Access Token**
+
+### Required Scopes by Object
+
+| Objects | Scopes |
+|---------|--------|
+| Contacts | `crm.objects.contacts.read`, `crm.objects.contacts.write` |
+| Companies | `crm.objects.companies.read`, `crm.objects.companies.write` |
+| Deals | `crm.objects.deals.read`, `crm.objects.deals.write` |
+| Tickets | `tickets` (read + write) |
+| Custom Objects | `crm.objects.custom.read`, `crm.objects.custom.write` |
+
+---
+
+## LangChain CRM Agent Example
+
+```python
+from matimo import Matimo
+from matimo_hubspot import get_tools_path
+from matimo.integrations.langchain import convert_tools_to_langchain
+from langchain_openai import ChatOpenAI
+from langchain.agents import AgentExecutor, create_tool_calling_agent
+from langchain_core.prompts import ChatPromptTemplate
+
+matimo = await Matimo.init(get_tools_path())
+lc_tools = convert_tools_to_langchain(
+    matimo.list_tools(), matimo,
+    credentials={'HUBSPOT_ACCESS_TOKEN': os.environ['HUBSPOT_ACCESS_TOKEN']},
+)
+llm = ChatOpenAI(model='gpt-4o-mini')
+prompt = ChatPromptTemplate.from_messages([
+    ('system', 'You are a CRM assistant.'),
+    ('human', '{input}'),
+    ('placeholder', '{agent_scratchpad}'),
+])
+agent = create_tool_calling_agent(llm, lc_tools, prompt)
+executor = AgentExecutor(agent=agent, tools=lc_tools)
+result = await executor.ainvoke({'input': 'Find all open deals and summarize pipeline status'})
+```
+
+---
+
+## Documentation
+
+- [HubSpot CRM API](https://developers.hubspot.com/docs/api/crm/crm-introduction)
+- [Python Examples](https://github.com/tallclub/matimo/tree/main/python/examples/native/hubspot)
+
+---
+
+## Links
+
+- **PyPI:** https://pypi.org/project/matimo-hubspot/
+- **GitHub:** https://github.com/tallclub/matimo
+- **HubSpot Developer Docs:** https://developers.hubspot.com/
+

matimo_hubspot-0.1.0/README.md

@@ -0,0 +1,142 @@
+# matimo-hubspot
+
+> HubSpot CRM tools for [Matimo](https://matimo.dev) — manage contacts, companies, deals, tickets, and more.
+
+[![PyPI](https://img.shields.io/pypi/v/matimo-hubspot)](https://pypi.org/project/matimo-hubspot/)
+[![Docs](https://img.shields.io/badge/docs-matimo.dev-blue)](https://matimo.dev/docs)
+
+---
+
+## Installation
+
+```bash
+pip install matimo matimo-hubspot
+```
+
+---
+
+## Available Tools (50 Total)
+
+Full CRUD coverage across 10 HubSpot object types:
+
+| Object | Create | Get | List | Update | Delete |
+|--------|:------:|:---:|:----:|:------:|:------:|
+| Contacts | ✅ | ✅ | ✅ | ✅ | ✅ |
+| Companies | ✅ | ✅ | ✅ | ✅ | ✅ |
+| Deals | ✅ | ✅ | ✅ | ✅ | ✅ |
+| Tickets | ✅ | ✅ | ✅ | ✅ | ✅ |
+| Leads | ✅ | ✅ | ✅ | ✅ | ✅ |
+| Products | ✅ | ✅ | ✅ | ✅ | ✅ |
+| Line Items | ✅ | ✅ | ✅ | ✅ | ✅ |
+| Orders | ✅ | ✅ | ✅ | ✅ | ✅ |
+| Invoices | ✅ | ✅ | ✅ | ✅ | ✅ |
+| Custom Objects | ✅ | ✅ | ✅ | ✅ | ✅ |
+
+### Tool naming convention: `hubspot-{verb}-{object}`
+
+Examples: `hubspot-create-contact`, `hubspot-list-deals`, `hubspot-update-ticket`, `hubspot-delete-company`
+
+---
+
+## Quick Start
+
+```python
+import asyncio
+import os
+from matimo import Matimo
+from matimo_hubspot import get_tools_path
+
+async def main():
+    matimo = await Matimo.init(get_tools_path())
+
+    # Create a contact
+    contact = await matimo.execute('hubspot-create-contact', {
+        'firstname': 'Jane',
+        'lastname': 'Smith',
+        'email': 'jane@example.com',
+        'company': 'Acme Corp',
+    })
+
+    # List all deals
+    deals = await matimo.execute('hubspot-list-deals', {
+        'limit': 20,
+    })
+
+    # Update a ticket
+    await matimo.execute('hubspot-update-ticket', {
+        'ticket_id': '12345',
+        'subject': 'Updated subject',
+        'hs_pipeline_stage': '4',
+    })
+
+asyncio.run(main())
+```
+
+---
+
+## Authentication
+
+```bash
+export HUBSPOT_ACCESS_TOKEN="pat-na1-your-private-app-token"
+```
+
+### Setting Up a HubSpot Private App
+
+1. In HubSpot, go to **Settings** → **Integrations** → **Private Apps**
+2. Click **Create a private app**
+3. Under **Scopes**, select the CRM scopes you need (see table below)
+4. Copy the **Access Token**
+
+### Required Scopes by Object
+
+| Objects | Scopes |
+|---------|--------|
+| Contacts | `crm.objects.contacts.read`, `crm.objects.contacts.write` |
+| Companies | `crm.objects.companies.read`, `crm.objects.companies.write` |
+| Deals | `crm.objects.deals.read`, `crm.objects.deals.write` |
+| Tickets | `tickets` (read + write) |
+| Custom Objects | `crm.objects.custom.read`, `crm.objects.custom.write` |
+
+---
+
+## LangChain CRM Agent Example
+
+```python
+from matimo import Matimo
+from matimo_hubspot import get_tools_path
+from matimo.integrations.langchain import convert_tools_to_langchain
+from langchain_openai import ChatOpenAI
+from langchain.agents import AgentExecutor, create_tool_calling_agent
+from langchain_core.prompts import ChatPromptTemplate
+
+matimo = await Matimo.init(get_tools_path())
+lc_tools = convert_tools_to_langchain(
+    matimo.list_tools(), matimo,
+    credentials={'HUBSPOT_ACCESS_TOKEN': os.environ['HUBSPOT_ACCESS_TOKEN']},
+)
+llm = ChatOpenAI(model='gpt-4o-mini')
+prompt = ChatPromptTemplate.from_messages([
+    ('system', 'You are a CRM assistant.'),
+    ('human', '{input}'),
+    ('placeholder', '{agent_scratchpad}'),
+])
+agent = create_tool_calling_agent(llm, lc_tools, prompt)
+executor = AgentExecutor(agent=agent, tools=lc_tools)
+result = await executor.ainvoke({'input': 'Find all open deals and summarize pipeline status'})
+```
+
+---
+
+## Documentation
+
+- [HubSpot CRM API](https://developers.hubspot.com/docs/api/crm/crm-introduction)
+- [Python Examples](https://github.com/tallclub/matimo/tree/main/python/examples/native/hubspot)
+
+---
+
+## Links
+
+- **PyPI:** https://pypi.org/project/matimo-hubspot/
+- **GitHub:** https://github.com/tallclub/matimo
+- **HubSpot Developer Docs:** https://developers.hubspot.com/
+

matimo_hubspot-0.1.0/pyproject.toml

@@ -0,0 +1,27 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "matimo-hubspot"
+version = "0.1.0"
+description = "Matimo provider — HubSpot CRM tools (contacts, deals, companies, tickets)"
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.11"
+keywords = ["ai", "tools", "agents", "matimo", "hubspot"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3.11",
+]
+dependencies = [
+    "matimo-core>=0.1.0,<0.2.0",
+]
+
+[project.entry-points."matimo.providers"]
+hubspot = "matimo_hubspot:get_tools_path"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/matimo_hubspot"]

matimo_hubspot-0.1.0/src/matimo_hubspot/__init__.py

@@ -0,0 +1,17 @@
+"""Matimo hubspot provider — exposes the path to YAML tool definitions."""
+from __future__ import annotations
+
+import importlib.resources
+from pathlib import Path
+
+
+def get_tools_path() -> str:
+    """Return the absolute path to the bundled hubspot tool definitions."""
+    try:
+        ref = importlib.resources.files("matimo_hubspot") / "tools"
+        return str(ref)
+    except Exception:
+        return str(Path(__file__).parent / "tools")
+
+
+__all__ = ["get_tools_path"]

matimo_hubspot-0.1.0/src/matimo_hubspot/tools/hubspot-create-company/definition.yaml

@@ -0,0 +1,57 @@
+name: hubspot-create-company
+version: '1.0.0'
+description: Create a new company in HubSpot CRM.
+
+parameters:
+  name:
+    type: string
+    required: true
+    description: Company name
+  domain:
+    type: string
+    required: false
+    description: Company domain
+
+execution:
+  type: http
+  method: POST
+  url: 'https://api.hubapi.com/crm/v3/objects/companies'
+  headers:
+    Authorization: 'Bearer {MATIMO_HUBSPOT_API_KEY}'
+    Content-Type: application/json
+  body:
+    properties:
+      name: '{name}'
+      domain: '{domain}'
+  timeout: 30000
+
+authentication:
+  type: bearer
+  location: header
+  name: Authorization
+  notes:
+    env: MATIMO_HUBSPOT_API_KEY
+
+output_schema:
+  type: object
+  properties:
+    id: { type: string }
+    properties: { type: object }
+    createdAt: { type: string }
+  required: [id, properties]
+
+error_handling:
+  retry: 2
+  backoff_type: exponential
+  initial_delay_ms: 500
+
+examples:
+  - name: 'Create company with name'
+    params:
+      name: 'Acme Corp'
+    expected_result: 'Company created with id and properties.'
+  - name: 'Create company with name and domain'
+    params:
+      name: 'Tech Startup Inc'
+      domain: 'techstartup.com'
+    expected_result: 'Company created with name and domain.'

matimo_hubspot-0.1.0/src/matimo_hubspot/tools/hubspot-create-contact/definition.yaml

@@ -0,0 +1,79 @@
+name: hubspot-create-contact
+version: '1.0.0'
+description: Create a new contact in HubSpot CRM.
+
+parameters:
+  email:
+    type: string
+    required: true
+    description: Email address of the contact
+  firstname:
+    type: string
+    required: false
+    description: First name of the contact
+  lastname:
+    type: string
+    required: false
+    description: Last name of the contact
+  phone:
+    type: string
+    required: false
+    description: Phone number of the contact
+  company:
+    type: string
+    required: false
+    description: Company name of the contact
+
+execution:
+  type: http
+  method: POST
+  url: 'https://api.hubapi.com/crm/v3/objects/contacts'
+  headers:
+    Authorization: 'Bearer {MATIMO_HUBSPOT_API_KEY}'
+    Content-Type: application/json
+  body:
+    properties:
+      email: '{email}'
+      firstname: '{firstname}'
+      lastname: '{lastname}'
+      phone: '{phone}'
+      company: '{company}'
+  timeout: 30000
+
+authentication:
+  type: bearer
+  location: header
+  name: Authorization
+  notes:
+    env: MATIMO_HUBSPOT_API_KEY
+
+output_schema:
+  type: object
+  properties:
+    id: { type: string }
+    properties: { type: object }
+    createdAt: { type: string }
+    updatedAt: { type: string }
+    archived: { type: boolean }
+  required: [id, properties, createdAt, updatedAt, archived]
+
+error_handling:
+  retry: 2
+  backoff_type: exponential
+  initial_delay_ms: 500
+
+examples:
+  - name: 'Create contact with email and name'
+    params:
+      email: 'test@example.com'
+      firstname: 'Test'
+      lastname: 'User'
+    expected_result: 'Contact created with id and properties.'
+  - name: 'Create contact with all fields'
+    params:
+      email: 'custom@example.com'
+      firstname: 'John'
+      lastname: 'Doe'
+      phone: '+1234567890'
+      company: 'Acme Corp'
+    expected_result: 'Contact created with all properties.'

matimo_hubspot-0.1.0/src/matimo_hubspot/tools/hubspot-create-custom-object/definition.yaml

@@ -0,0 +1,57 @@
+name: hubspot-create-custom-object
+version: '1.0.0'
+description: Create a new custom object in HubSpot CRM.
+
+parameters:
+  object_type:
+    type: string
+    required: true
+    description: The custom object type ID (e.g., 'my_custom_object')
+  name:
+    type: string
+    required: false
+    description: Custom object name
+  description:
+    type: string
+    required: false
+    description: Custom object description
+
+execution:
+  type: http
+  method: POST
+  url: 'https://api.hubapi.com/crm/v3/objects/{object_type}'
+  headers:
+    Authorization: 'Bearer {MATIMO_HUBSPOT_API_KEY}'
+    Content-Type: application/json
+  body:
+    properties:
+      name: '{name}'
+      description: '{description}'
+  timeout: 30000
+
+authentication:
+  type: bearer
+  location: header
+  name: Authorization
+
+output_schema:
+  type: object
+  properties:
+    id:
+      type: string
+    properties:
+      type: object
+
+error_handling:
+  retry: 2
+  backoff_type: exponential
+  initial_delay_ms: 500
+
+requires_approval: false
+
+examples:
+  - name: Create a custom object
+    params:
+      object_type: my_custom_object
+      name: Custom Object 1
+    expected_result: Custom object created with id and properties.

matimo_hubspot-0.1.0/src/matimo_hubspot/tools/hubspot-create-deal/definition.yaml

@@ -0,0 +1,69 @@
+name: hubspot-create-deal
+version: '1.0.0'
+description: Create a new deal in HubSpot CRM.
+
+parameters:
+  dealname:
+    type: string
+    required: true
+    description: Name of the deal
+  dealstage:
+    type: string
+    required: true
+    description: Pipeline stage of the deal (e.g., negotiation, contractsent, won)
+  pipeline:
+    type: string
+    required: false
+    description: Pipeline ID (uses default if not specified)
+  amount:
+    type: number
+    required: false
+    description: Deal amount
+  closedate:
+    type: string
+    required: false
+    description: Close date in ISO format (YYYY-MM-DDTHH:mm:ss.sssZ)
+
+execution:
+  type: http
+  method: POST
+  url: 'https://api.hubapi.com/crm/v3/objects/deals'
+  headers:
+    Authorization: 'Bearer {MATIMO_HUBSPOT_API_KEY}'
+    Content-Type: application/json
+  body:
+    properties:
+      dealname: '{dealname}'
+      dealstage: '{dealstage}'
+      pipeline: '{pipeline}'
+      amount: '{amount}'
+      closedate: '{closedate}'
+  timeout: 30000
+
+authentication:
+  type: bearer
+  location: header
+  name: Authorization
+  notes:
+    env: MATIMO_HUBSPOT_API_KEY
+
+output_schema:
+  type: object
+  properties:
+    id: { type: string }
+    properties: { type: object }
+    createdAt: { type: string }
+  required: [id, properties]
+
+error_handling:
+  retry: 2
+  backoff_type: exponential
+  initial_delay_ms: 500
+
+examples:
+  - name: 'Create deal with name and stage'
+    params:
+      dealname: 'Enterprise Sale'
+      dealstage: 'negotiation'
+      amount: 50000
+    expected_result: 'Deal created with id and properties.'