@morphixai/mcp-server

<h1 align="center">MorphixAI AI Agent Plugins</h1>

<p align="center"> <a href="https://morphix.app">morphix.app</a> </p>

<p align="center"> <strong>English</strong> | <a href="./README.zh-CN.md">简体中文</a> </p>

This repository contains the official integrations for MorphixAI, allowing various AI Agents (such as OpenClaw, Claude Code, Cursor, and Windsurf) to seamlessly interact with workplace tools like GitHub, GitLab, Jira, Notion, Google Workspace, and Office 365.

📦 Architecture

This repository is structured as a pnpm workspace monorepo to ensure maximum code reuse and pure dependency trees for different platforms.

@morphixai/core: The platform-agnostic core engine. It contains all API clients, authentication logic, and TypeBox schemas.
openclaw-morphixai: The adapter for OpenClaw. It exposes tools and skill prompts native to the OpenClaw Agent ecosystem.
@morphixai/mcp-server: The adapter for MCP (Model Context Protocol). It exposes the core capabilities as a standard MCP server, making it compatible with Claude Code, Cursor, and Claude Desktop.

🚀 Installation & Usage

1. For Claude Code, Cursor, Windsurf (MCP Users)

If your AI assistant supports the Model Context Protocol (MCP), you can install the MorphixAI server globally.

# 1. Install the MCP server globally
npm install -g @morphixai/mcp-server

For Claude Code: Add the MCP server to your Claude Code configuration by passing your Morphix API Key:

claude mcp add morphixai-mcp -- npx -y @morphixai/mcp-server --env MORPHIXAI_API_KEY="mk_your_api_key_here"

For Claude Desktop / Cursor: Add the following to your claude_desktop_config.json or Cursor MCP settings:

{
  "mcpServers": {
    "morphixai": {
      "command": "npx",
      "args": ["-y", "@morphixai/mcp-server"],
      "env": {
        "MORPHIXAI_API_KEY": "mk_your_api_key_here"
      }
    }
  }
}

2. For OpenClaw Users

Install the plugin directly within your OpenClaw environment:

openclaw plugins install openclaw-morphixai

Note: The legacy package openclaw-morphix has been deprecated, but installing it will safely proxy to openclaw-morphixai.

🔑 Getting Started

Register / Login: Visit morphix.app to create your MorphixAI account or sign in.
Get your API Key: Go to MorphixAI API Keys and create a new key (format: mk_xxxxxx).
Link your accounts (optional): Visit MorphixAI Connections to connect third-party platforms (GitHub, Jira, Notion, etc.) that you want to use through AI agents.
Configure your environment: Pass the key via the MORPHIXAI_API_KEY environment variable, then follow the Installation instructions above for your AI agent.

🧩 Skills

MorphixAI provides the following skills (capabilities) for AI agents to interact with workplace tools:

Skill	Tool	Description
GitHub Workflow	`mx_github`	Repository, Issue, Pull Request management and GitHub Actions workflow triggering
GitLab Workflow	`mx_gitlab`	MR/Issue/Pipeline/Branch management with code review best practices
Jira Workflow	`mx_jira`	Project listing, JQL-based issue search, issue CRUD, status transitions, comments (Markdown auto-converts to ADF)
Notion	`mx_notion`	Page/database CRUD, block management, knowledge base search
Confluence	`mx_confluence`	Space/page CRUD, label management, comments, CQL search
Figma	`mx_figma`	Browse projects/files, export images, manage comments, view components/styles/design tokens
Outlook Email	`mx_outlook`	List/search/send/reply messages, folder management
Outlook Calendar	`mx_outlook_calendar`	Calendar/event CRUD, calendar view, attendee management
Gmail	`mx_gmail`	List/search/send messages, label management (requires linking Gmail account)
Microsoft To Do	`mx_ms_todo`	Task list and task CRUD, complete tasks, importance/status management
Google Tasks	`mx_google_tasks`	Task list and task CRUD (requires linking Google Tasks account)
Flights	`mx_flights`	Airport/flight search, offer details, seat maps, order booking and management (powered by Duffel)
Daily Standup	composite	Aggregates data from GitLab, GitHub, Jira, Email, Calendar, and Tasks into a concise daily report. Triggered by keywords like "standup", "日报", "早报"
Office Link	`mx_link`	Unified entry point: account management, connect 40+ platforms, and API proxy for platforms without dedicated skills

Note: All skills require a MORPHIXAI_API_KEY. Platforms with dedicated skills (e.g., GitHub, Jira) should always use those skills directly instead of mx_link proxy.

🛠️ Development

# Install dependencies
pnpm install

# Build all packages
pnpm build

# Run tests
pnpm test

License

MIT