X (Twitter)LinkedInGitHubDiscordYouTube

How to connect Simplekpi to Claude

Connect Claude Web, Desktop and Cowork to Simplekpi MCP. Show me top performing kpis this month, add a new kpi for sales pipeline, and more using natural language, with authentication handled for you.

Get started for freeGet a demo
Simplekpi logoSimplekpi
Basic

Simplekpi is cloud-based KPI software that lets you create, manage, and analyze performance indicators. It streamlines tracking and reporting so you can focus on actionable insights.

51 Tools

Introduction

Claude is Anthropic's AI assistant, available on the web, in the desktop app, and on mobile. Cowork is its agent for knowledge work, and it runs on all of those surfaces too. Connected to your apps, Claude can work with your files and services to accomplish complex tasks on your behalf.

This guide walks you through the easiest and most secure way to connect your Simplekpi account to Claude via Composio Connect, enabling it to show me top performing KPIs this month, add a new KPI for sales pipeline, generate a report on marketing metrics, and more such actions on your behalf without compromising your account security.

Setup is the same on Claude Web, Desktop, and Cowork, and you only need to do it once. The connector is tied to your account, so it's available in all three.

Also integrate Simplekpi with

Claude CodeOpenAI Agents SDKClaude Agent SDKCodexOpenClawHermesAtomic AgentGoogle ADKLangChainVercel AI SDKMastra AILlamaIndexCrewAIPydantic AIAutoGen

Connecting Simplekpi to Claude Web, Desktop, and Cowork

Two ways to add the Composio connector. Pick whichever you prefer.

1. Add with one click

Click the button. Claude opens with the Composio connector filled in. Click Add, then go to step 2.

Add to Claude

Add manually

In Claude Desktop, click Customize in the left sidebar, then select Connectors and click the + icon at the top.

Claude Desktop connectors screen with Add custom connector selected

Click Add custom connector and paste in the Composio MCP server URL:

bash
https://connect.composio.dev/mcp
Add custom connector dialog with Composio MCP server URL

2. Authorize in your browser

Click Connect. You'll be redirected to a browser window where you can authorize Composio to continue.

Composio authorization screen for Claude Web, Desktop, and Cowork

3. Connect your Simplekpi account

Back in Claude, ask it to connect to Simplekpi or give it any Simplekpi-related task.

For example, ask Claude to:

  • "Show me top performing KPIs this month"
  • "Add a new KPI for sales pipeline"
  • "Generate a report on marketing metrics"

It will prompt you to authenticate and authorize access.

That's it. Composio's tools are now available in Claude, and your Simplekpi account is ready to use.

What is the Simplekpi Claude Connector, and what's possible with it?

The Simplekpi MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Simplekpi account. It provides structured and secure access so your agent can perform Simplekpi operations on your behalf.

Troubleshooting

1. Why does Claude not use the Composio connector for Simplekpi?

The connector can show as connected, but Claude must use it in each Simplekpi conversation.

  • Click + at the lower left of the chat, or type /.
  • Hover Connectors.
  • Turn on Composio.
  • Ask Claude to connect to Simplekpi again.

2. Why does Claude show an MCP server error before Simplekpi connects?

Claude can show Couldn't reach the MCP server or Authorization with the MCP server failed when you add the connector for Simplekpi.

  • Check that the connector URL is https://connect.composio.dev/mcp.
  • Connectors run from Anthropic's cloud, so your device network is usually not the problem.
  • Add the connector again from Customize > Connectors, then ask Claude to connect Simplekpi.
  • If it fails again, send the error and the ofid_ reference id to support@composio.dev.

3. Why does the Simplekpi authorization link not work?

The Composio connector is one server. Your Simplekpi account connects separately when Claude asks for it.

  • If the browser does not open, or the link expires, ask Claude to retry the Simplekpi connection.
  • Composio creates a fresh Simplekpi authorization link.
  • Open that link in your browser and finish the Simplekpi sign-in.

4. Why do Simplekpi actions fail after they worked before?

The Simplekpi connection can expire or lose permission.

  • Ask Claude to inspect the Simplekpi connection.
  • If the connection is unhealthy, disconnect it when Claude prompts you.
  • Reconnect the Simplekpi account and retry the action.
  • If Claude shows a permission prompt, approve it before Claude changes data in Simplekpi.
  • If the action still fails with a permission error, check that the connected account has that permission in Simplekpi itself.

5. How do I switch to a different Simplekpi account?

Claude can manage the Simplekpi connection for you.

  • Ask Claude to disconnect or delete the current Simplekpi account.
  • Ask Claude to connect Simplekpi again.
  • Open the new Composio authorization link for Simplekpi.
  • Sign in with the other Simplekpi account in the browser.
  • After the account connects, ask Claude to retry the Simplekpi task.

6. Why is my Simplekpi connection missing in Claude Desktop or on a Team plan?

The connector belongs to your Claude account, so your Simplekpi connection works in Claude Web, Desktop, and Cowork.

  • In Claude Desktop, open Customize > Connectors.
  • Next to Composio, click ⋮ and click Clear cache.
  • If Simplekpi tools still do not appear, click ⋮, disconnect, remove the connector, and add it again.
  • On Team or Enterprise, an Owner or Primary Owner must enable the connector before you can connect Simplekpi.
TOOLS

Supported Tools

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

Add User Group Item

Tool to assign a group item to a user in SimpleKPI.

Add User KPI

Tool to assign a KPI to a user in SimpleKPI.

Create Category KPI

Tool to create a new KPI within a category in SimpleKPI.

Create Group

Tool to create a new group in SimpleKPI.

Create Group Item

Tool to create a new item within a group in SimpleKPI.

Create KPI

Tool to create a new KPI with specified configuration.

Create KPI Category

Tool to create a new KPI category in SimpleKPI.

Create KPI Unit

Tool to create a new KPI unit in SimpleKPI.

Batch KPI Entries

Tool to batch create or update multiple KPI entries at once.

Create User

Tool to create a new user account in SimpleKPI.

Delete Category KPI

Tool to delete a KPI from a category.

Delete Group

Tool to delete a group by ID.

Delete Group Item

Tool to delete a group item by ID.

Delete KPI

Tool to delete a KPI by ID.

Delete KPI Category

Tool to delete a KPI category by its ID.

Delete KPI Entry

Tool to delete a KPI entry by ID.

Delete KPI Unit

Tool to delete a KPI unit by its ID.

Delete User

Tool to delete a user account by ID.

Delete User Group Item

Tool to remove a group item assignment from a user.

Delete User KPI

Tool to remove a KPI assignment from a user.

Get All Data Entries

Tool to retrieve processed KPI data entries for reports including calculated KPIs.

Get Category KPI

Tool to retrieve a specific KPI within a category.

Get Group

Tool to get a specific group by ID from SimplekPI.

Get Group Item

Tool to retrieve a specific group item by ID.

Get KPI by ID

Tool to retrieve a specific KPI by ID from SimpleKPI.

Get KPI Category

Tool to get a specific KPI category by ID from SimpleKPI.

Get KPI Entry

Tool to retrieve a specific KPI entry by ID.

Get KPI Frequency

Tool to get a specific KPI frequency by ID from SimplekPI.

Get KPI Icon by ID

Tool to retrieve a specific KPI icon by ID.

Get KPI Unit

Tool to get a specific KPI unit by ID from SimpleKPI.

Get User by ID

Tool to retrieve a specific user by ID.

Get User Group Item

Tool to get a specific group item assigned to a user.

Get User KPI

Tool to retrieve a specific KPI assigned to a user.

List Category KPIs

Tool to retrieve all KPIs within a specific category.

List Group Items

Tool to get all items within a group.

List Groups

Tool to retrieve all groups from SimpleKPI.

List KPI Categories

Tool to get all KPI categories.

List KPI Entries

Tool to get all KPI entries filtered by date range and optional criteria.

List KPI Frequencies

Tool to get all KPI frequencies.

List KPI Icons

Tool to retrieve all KPI icons from SimpleKPI.

List All KPIs

Tool to retrieve all KPIs from a SimpleKPI account.

List All KPI Units

Tool to retrieve all KPI units from a SimpleKPI account.

List User Group Items

Tool to get all group items assigned to a user.

List User KPIs

Tool to get all KPIs assigned to a specific user.

Update Category KPI

Tool to update a KPI within a category.

Update Group

Tool to update an existing group in SimpleKPI.

Update Group Item

Tool to update an existing item in a SimpleKPI group.

Update KPI

Tool to update an existing KPI in SimpleKPI.

Update KPI Entry

Tool to update an existing KPI entry in SimpleKPI.

Update KPI Unit

Tool to update an existing KPI unit in SimpleKPI.

Update User

Tool to update an existing user account in SimpleKPI.

FRAMEWORKS

How to build Simplekpi MCP Agent with another framework

Claude Code logo

Claude Code

Use Simplekpi MCP with Claude Code

OpenAI Agents SDK logo

OpenAI Agents SDK

Use Simplekpi MCP with OpenAI Agents SDK

Claude Agent SDK logo

Claude Agent SDK

Use Simplekpi MCP with Claude Agent SDK

Codex logo

Codex

Use Simplekpi MCP with Codex

OpenClaw logo

OpenClaw

Use Simplekpi MCP with OpenClaw

Hermes logo

Hermes

Use Simplekpi MCP with Hermes

Atomic Agent logo

Atomic Agent

Use Simplekpi MCP with Atomic Agent

Google ADK logo

Google ADK

Use Simplekpi MCP with Google ADK

LangChain logo

LangChain

Use Simplekpi MCP with LangChain

Vercel AI SDK logo

Vercel AI SDK

Use Simplekpi MCP with Vercel AI SDK

Mastra AI logo

Mastra AI

Use Simplekpi MCP with Mastra AI

LlamaIndex logo

LlamaIndex

Use Simplekpi MCP with LlamaIndex

CrewAI logo

CrewAI

Use Simplekpi MCP with CrewAI

Pydantic AI logo

Pydantic AI

Use Simplekpi MCP with Pydantic AI

AutoGen logo

AutoGen

Use Simplekpi MCP with AutoGen

FAQ

Frequently asked questions

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

Yes, you can. Claude Cowork 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 Simplekpi tools.

Yes, absolutely. You can configure which Simplekpi 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 Simplekpi data and credentials are handled as safely as possible.

Start with Simplekpi.It takes 30 seconds.

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

Start building