composio

MCP server from comigor/composio-mcp-server

Installation

Run this command in your terminal to add the MCP server to Claude Code.

Run in terminal:

Command

claude mcp add --transport stdio comigor-composio-mcp-server node build/index.js \
  --env COMPOSIO_APPS="gmail,linear" \
  --env COMPOSIO_API_KEY="your_composio_api_key"

How to use

The Composio MCP Server exposes a standardized MCP interface for interacting with Composio-powered tools and actions, such as Gmail and Linear. This enables language models and automation pipelines to call Composio features through the MCP protocol, treating tools as discoverable actions with structured inputs and outputs. To start using it, ensure you have followed the installation prerequisites and started the server using the MCP configuration above. Once running, you can query the server for available actions (e.g., sending an email, fetching Gmail threads, creating or updating Linear tasks) and pass the required input payloads in the MCP request format to perform those actions. The server abstracts the underlying Composio API calls and presents a consistent, model-friendly interface for tool usage within your workflows.

How to install

Prerequisites:

Node.js v16+ installed on your machine
A Composio API key (sign up at https://app.composio.dev)

Installation steps:

Clone the repository and install dependencies: git clone https://github.com/composio/composio-mcp-server.git cd composio-mcp-server pnpm install
Build the project: pnpm build
Run the server (production-ready entry): node build/index.js
Alternatively, when using the MCP installation guide, start the server via the provided command template by exporting your API key and desired apps, then launching the built server: env COMPOSIO_API_KEY=<your_api_key> env COMPOSIO_APPS=gmail,linear node /path/to/repo/build/index.js

Notes:

Ensure your Node.js version matches the prerequisites.
Replace placeholder values with your actual Composio API key and app list.
The build output is located at build/index.js after a successful pnpm build.

Additional notes

Tips and common issues:

Ensure COMPOSIO_API_KEY is correctly set; invalid keys will cause authentication failures.
The COMPOSIO_APPS environment variable should list the apps you want accessible, e.g., gmail,linear. Separate multiple apps with commas.
If you modify environment settings or app permissions, restart the server to apply changes.
For troubleshooting, check the server logs for authentication errors, missing dependencies, or build issues.
This server is designed to be run in environments where Node.js is available and network access to Composio services is permitted.

Related MCP Servers

zen

1.1k

Selfhosted notes app. Single golang binary, notes stored as markdown within SQLite, full-text search, very low resource usage

MCP -Deepseek_R1

A Model Context Protocol (MCP) server implementation connecting Claude Desktop with DeepSeek's language models (R1/V3)

mcp-fhir

A Model Context Protocol implementation for FHIR

mcp

Inkdrop Model Context Protocol Server

mcp-appium-gestures

This is a Model Context Protocol (MCP) server providing resources and tools for Appium mobile gestures using Actions API..

dubco -npm

The (Unofficial) dubco-mcp-server enables AI assistants to manage Dub.co short links via the Model Context Protocol. It provides three MCP tools: create_link for generating new short URLs, update_link for modifying existing links, and delete_link for removing short links.