SIGN UPLOG IN
X (Twitter)LinkedInGitHubDiscordYouTube

How to integrate Tave MCP with Hermes

Connect Hermes to Tave MCP. List all open jobs assigned to me, add a new client to tave contacts, and more using natural language, with authentication handled for you.

Get started for freeGet a demo
Tave logoTave
Api Key

Tave is a studio management app for photographers, streamlining client management, job tracking, and business workflows. It helps studios stay organized and operate efficiently.

129 Tools

Introduction

Hermes is a 24/7 autonomous agent that lives on your computer or server — it remembers what it learns and evolves as your usage grows.

This guide explains the easiest and most robust way to connect your Tave account to Hermes. You can do this through either Composio Connect CLI or Composio Connect MCP. For personal use we recommend the CLI, but you won't go wrong with MCP either.

Also integrate Tave with

Claude CodeClaude CoworkOpenAI Agents SDKClaude Agent SDKCodexOpenClawAtomic AgentGoogle ADKLangChainVercel AI SDKMastra AILlamaIndexCrewAIPydantic AIAutoGen

What is Composio Connect?

Composio Connect is a consumer offering that lets anyone plug 1,500+ applications directly into their agent harness — including Hermes. It can:

  • Search and load tools from relevant toolkits on-demand, reducing context usage.
  • Chain multiple tools to accomplish complex workflows via a remote workbench, without excessive back-and-forth with the LLM.
  • Manage app authentication end-to-end with zero manual overhead.

Integrating Tave with Hermes

Using Composio Connect CLI

1. Install the Composio CLI

Run the install script directly, or paste https://composio.dev/hermes into your Hermes chat box to have it installed for you.

bash
curl -fsSL https://composio.dev/install | bash
Hermes authenticating with Composio

2. Authenticate

Once the CLI is installed, ask Hermes to authenticate with Composio.

3. Connect to Tave

Ask your agent to connect to Tave, or simply request any Tave-related task. Hermes will prompt you to authenticate and authorize access.

4. Done. You're all set with a new Tave connection.

Using Composio Connect MCP

1. Get your MCP URL and API Key

Go to dashboard.composio.dev and copy your Connect MCP URL and API key.

Copy MCP URL and API key from Composio dashboard

2. Open the Hermes config file

bash
nano ~/.hermes/config.yaml

3. Add the Composio Connect MCP server

bash
mcp_servers:
  composio:
    url: "https://connect.composio.dev/mcp"
    headers:
      x-consumer-api-key: "YOUR_COMPOSIO_API_KEY"
    connect_timeout: 60
    timeout: 180

Save with Ctrl + O, Enter, then exit with Ctrl + X.

4. Restart your Hermes agent

Once restarted, ask your agent to connect to Tave or request any Tave-related task. It will prompt you to authenticate and authorize access.

5. Done!

What is the Tave MCP server, and what's possible with it?

The Tave MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Tave account. It provides structured and secure access to your studio's clients, jobs, orders, and payments, so your agent can manage contacts, create and update jobs, track orders, record payments, and review studio activity on your behalf.

  • Client and contact management: Have your agent list, create, review, and update contacts in your studio address book.
  • Photography job tracking: Let the agent create new jobs, review existing work, update job details, or delete canceled jobs.
  • Job contact coordination: Direct your agent to add, review, and update the contacts associated with each photography job.
  • Order management: Instruct your agent to create orders for jobs, review current orders, and update order details as plans change.
  • Payment recording: Have your agent create and review payments, then apply payments to the correct client orders.

Way Forward

With Tave connected, Hermes can now act on your behalf whenever it detects a relevant task or you ask it to.

From here, you can extend Hermes further:

  • Connect more apps: Calendar, Slack, Notion, Linear, and hundreds of others are available through the same Composio Connect setup. Each new integration compounds what Hermes can do for you.
  • Build workflows across tools: Once multiple apps are connected, Hermes can chain actions together — turn an email into a calendar invite, a Slack message into a Linear ticket, or a meeting note into a follow-up draft.
  • Let it learn your patterns: The more you use Hermes, the better it gets at anticipating how you'd handle recurring tasks. Give it feedback on drafts and decisions, and it will adapt.

If you run into trouble or want to share what you've built, join the community or check out the Docs for deeper configuration options.

TOOLS

Supported Tools

Every Tave action and event your agent gets out of the box.

Apply Payment to Order

Tool to apply a payment to a specific order in Tave.

Create Brand

Tool to create a new brand in VSCO Workspace.

Create Custom Field

Tool to create a custom field in Tave for Jobs or Contacts.

Create Discount Type

Tool to create a new discount type in Tave.

Create Gallery

Tool to create a new gallery in Tave (VSCO Workspace).

Create Address Book Entry

Tool to create an entry in the address book.

Create Discount

Tool to create a discount in Tave.

Create Event

Tool to create a new event in Tave (VSCO Workspace).

Create Event Type

Tool to create a new event type in Tave.

Create File

Tool to create a file in Tave.

Create Job

Tool to create a new job in Tave (VSCO Workspace).

Create Job Closed Reason

Tool to create a job closed reason in Tave.

Create Job Contact

Tool to create a job contact in Tave.

Create Job Order

Tool to create an order on a job in Tave (VSCO Workspace).

Create Job Role

Tool to create a job role in Tave (VSCO Workspace).

Create Job Type

Tool to create a new job type in Tave.

Create Job Worksheet

Tool to create a job using a worksheet in Tave (VSCO Workspace).

Create Lead Source

Tool to create a lead source in Tave.

Create Lead Status

Tool to create a lead status in Tave.

Create Note

Tool to create a note in Tave (VSCO Workspace).

Create Payment

Tool to create a payment in Tave.

Create Product

Tool to create a product in Tave.

Create Product Type

Tool to create a product type in Tave.

Create Profit Center

Tool to create a profit center in Tave.

Create RestHook Subscription

Tool to create a RestHook webhook subscription in Tave.

Create Tax Rate

Tool to create a tax rate in Tave.

Create User

Tool to create a new user in Tave.

Delete Address Book Entry

Tool to delete an entry in the address book.

Delete Brand

Tool to delete a brand by its ULID.

Delete Custom Field

Tool to delete a custom field by its ULID identifier.

Delete Event Type

Tool to delete an event type by its ULID identifier.

Delete Gallery

Permanently delete a gallery by its ULID.

Delete Discount

Delete a specific discount by its ULID to permanently remove it from the system.

Delete Discount Type

Tool to delete a specific discount type by its ULID.

Delete Event

Tool to delete an event by its ULID identifier.

Delete Job

Tool to delete a job by its ULID identifier.

Delete Job Closed Reason

Tool to delete a job closed reason by its ULID identifier.

Delete Job Contact

Tool to delete a job contact by its ULID.

Delete Job Role

Tool to delete a job role by its ULID identifier.

Delete Job Type

Tool to delete a job type by its ULID.

Delete Lead Source

Tool to delete a specific lead source by its ULID.

Delete Lead Status

Tool to delete a specific lead status by its ULID.

Delete Note

Tool to delete a note by its ULID identifier.

Delete Payment

Tool to delete a specific payment by its ULID.

Delete Product

Tool to delete a specific product by its ULID.

Delete Product Type

Tool to delete a specific product type by its ULID.

Delete Profit Center

Tool to delete a profit center by its ULID.

Delete RestHook

Tool to unsubscribe from and delete a RestHook webhook subscription by its ULID.

Delete Tax Group

Tool to delete a specific tax group by its ULID.

Delete Tax Rate

Tool to delete a specific tax rate by its ULID.

Delete User

Tool to delete a user by its ULID.

Get Brand

Tool to retrieve a specific brand from Tave by its ULID.

Get Event

Tool to get a specific event by its ID.

Get Event Type

Tool to retrieve a specific event type by ID.

Get Gallery

Retrieve a specific gallery by ID from Tave/VSCO Workspace, including its status, photo count, cover photo, and metadata.

Get Address Book Entity

Tool to fetch a specific Address Book entity by its ULID.

Get Address Book Address

Tool to fetch the address associated with a given location ID.

Get Custom Field

Tool to fetch a specific custom field by ID from Tave.

Get Discount

Tool to retrieve a specific discount by its ID.

Get Discount Type

Tool to get a specific discount type by ID.

Get Job

Tool to fetch a specific job by ID from Tave.

Get Job Closed Reason

Tool to retrieve a specific job closed reason by its ID.

Get Job Contact

Tool to fetch a specific job contact by ID from Tave.

Get Job Role

Tool to retrieve a specific job role by its ID.

Get Job Type

Tool to retrieve a specific job type by ID.

Get Job Worksheet

Tool to fetch a Job Worksheet for a specific job by job ID.

Get Lead Source

Tool to retrieve a specific lead source by its ID.

Get Lead Status

Tool to retrieve a specific lead status by its ID.

Get My Studio

Tool to retrieve information about your studio from Tave.

Get Note

Tool to fetch a specific note by ID from Tave.

Get Order

Tool to fetch a specific order by ID from Tave.

Get Payment

Tool to fetch a specific payment by ID from Tave.

Get Payment Method

Tool to retrieve a specific payment method by its ID.

Get Product

Tool to retrieve a specific product by its ID.

Get Product Type

Tool to retrieve a specific product type by its ID.

Get Profit Center

Tool to retrieve a specific profit center by its ID.

Get Tax Rate

Tool to retrieve a specific tax rate by its ULID.

Get Timezone

Tool to retrieve a specific timezone by its ULID from Tave.

Get User by ID

Tool to retrieve a specific user by their ULID identifier.

List Address Book Contacts

Tool to list contacts in the studio's address book.

List Brands

List a page of brands configured for a studio, with pagination, hidden-brand inclusion, external mapping ID filtering, and sorting options.

List Discount Types

Tool to get a list of discount types from Tave.

List Studio Events

Tool to list a studio's events from Tave.

List Event Types

List a studio's event types, with pagination and optional visibility and external mapping filters.

List Files

Tool to list files in Tave.

List Resource Custom Fields

Tool to list custom fields configured on a studio.

List Resource Discount

Tool to get a list of discounts from Tave.

List Galleries

Tool to list all galleries for a studio.

List Resource Job

List a page of jobs for a studio, with optional filtering by closed status or external mapping ID and configurable pagination and sorting.

List Job Closed Reasons

List a page of a studio's job closed reasons, with optional filtering and sorting.

List Resource Job Contact

Tool to list a job's contacts.

List Resource Job Orders

Tool to list orders on a given job.

List Job Payments

Tool to get a list of payments for a specific job.

List Job Roles

List a page of a studio's job roles, with optional filtering and sorting.

List Resource Job Type

List a page of job types for a studio, with optional filtering by hidden status or external mapping ID.

List Resource Lead Source

List a page of a studio's lead sources for tracking where leads originated.

List Resource Lead Status

List a page of a studio's lead statuses for tracking leads in the sales pipeline, with pagination and filtering options.

List Resource Note

List notes from Tave with pagination and filtering, including a filter for notes associated with a job.

List Resource Order

Tool to get a list of all orders.

List Resource Payment

Tool to get a list of payments from Tave.

List Resource Payment Method

Tool to get a list of payment methods from Tave.

List Resource Product

Tool to get a list of products from Tave.

List Product Types

List a page of product types in Tave, with pagination and sorting options.

List Resource Profit Center

List a page of a studio's profit centers, with pagination, sorting, and filtering options for tracking business segments or cost centers.

List REST Hooks

Tool to list REST hooks configured in Tave.

List Resource Tax Groups

Tool to get a list of Tax Groups from Tave.

List Resource Tax Rates

Tool to get a list of tax rates from Tave.

List Resource Timezone

Tool to get a list of timezones from Tave.

List Resource User

List a page of users for the studio account, with pagination and sorting options.

Update Address Book Entry

Update a specific Tave address book entry by ID, including its contact information or entry type.

Update Brand

Tool to update a specific brand in Tave.

Update Event Type

Tool to update an existing event type in Tave.

Update Custom Field

Tool to update a specific custom field in Tave.

Update Event

Tool to update a specific event in Tave.

Update Gallery

Tool to update a specific gallery in Tave (VSCO Workspace).

Update Job

Tool to update a specific job in Tave (VSCO Workspace).

Update Job Closed Reason

Tool to update a job closed reason in Tave.

Update Job Contact

Tool to update a specific job contact in Tave.

Update Job Role

Tool to update a job role in Tave.

Update Job Type

Tool to update an existing job type in Tave.

Update Lead Source

Tool to update a specific lead source in Tave.

Update Lead Status

Tool to update a specific lead status in Tave.

Update Note

Update a specific note in Tave, supplying its HTML content and optionally modifying properties such as its associated job, contact, or visibility.

Update Order

Tool to update a specific order in Tave (VSCO Workspace).

Update Profit Center

Tool to update a specific profit center in Tave.

Update Tax Group

Tool to update a specific tax group in Tave.

Update Tax Rate

Tool to update a specific tax rate in Tave.

Update User

Tool to update a specific user in Tave.

Update Studio Readonly Mode

Tool to set studio readonly mode in Tave.

FRAMEWORKS

How to build Tave MCP Agent with another framework

Claude Code logo

Claude Code

Use Tave MCP with Claude Code

Claude Cowork logo

Claude Cowork

Use Tave MCP with Claude Cowork

OpenAI Agents SDK logo

OpenAI Agents SDK

Use Tave MCP with OpenAI Agents SDK

Claude Agent SDK logo

Claude Agent SDK

Use Tave MCP with Claude Agent SDK

Codex logo

Codex

Use Tave MCP with Codex

OpenClaw logo

OpenClaw

Use Tave MCP with OpenClaw

Atomic Agent logo

Atomic Agent

Use Tave MCP with Atomic Agent

Google ADK logo

Google ADK

Use Tave MCP with Google ADK

LangChain logo

LangChain

Use Tave MCP with LangChain

Vercel AI SDK logo

Vercel AI SDK

Use Tave MCP with Vercel AI SDK

Mastra AI logo

Mastra AI

Use Tave MCP with Mastra AI

LlamaIndex logo

LlamaIndex

Use Tave MCP with LlamaIndex

CrewAI logo

CrewAI

Use Tave MCP with CrewAI

Pydantic AI logo

Pydantic AI

Use Tave MCP with Pydantic AI

AutoGen logo

AutoGen

Use Tave MCP with AutoGen

FAQ

Frequently asked questions

With a standalone Tave MCP server, the agents and LLMs can only access a fixed set of Tave tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Tave and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Hermes fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Tave tools.

Yes, absolutely. You can configure which Tave scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Tave data and credentials are handled as safely as possible.

Start with Tave.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Tave tool your agent needs.Free to start.

Start building