Enables configuration of microCMS credentials through environment variables loaded from a .env file.
Provides code linting capabilities for the project, available through npm scripts.
Serves as the runtime environment for the MCP server, with a minimum requirement of Node.js 18.0.0 or higher.
Used for package management and running scripts to build, start, and develop the MCP server.
Offers code formatting functionality for the project, available through npm scripts.
Used as the development language for the MCP server, with build scripts to compile TypeScript to JavaScript.
microCMS MCP Server
A Model Context Protocol (MCP) server for microCMS API integration. This server enables AI assistants like Claude to interact with microCMS content management system.
Features
- Content Management: Full CRUD operations for microCMS list-type APIs
- Eight Core Tools:
microcms_get_list
- Retrieve content lists with filtering and paginationmicrocms_get_content
- Get individual content itemsmicrocms_create_content
- Create new contentmicrocms_update_content
- Update content (PUT)microcms_patch_content
- Partially update content (PATCH)microcms_delete_content
- Delete contentmicrocms_get_media
- Retrieve media files (Management API)microcms_upload_media
- Upload media files (Management API)
- Full API Support: Supports all microCMS query parameters including drafts, filters, pagination, and depth expansion
Requirements
- Node.js 18.0.0 or higher
- microCMS account and API key
Installation
Method 1: Using npx (Recommended)
No installation required! Use directly with npx:
Method 2: Global Installation
Method 3: Development Setup
- Clone this repository
- Install dependencies:
- Build the project:
Configuration
You can configure microCMS credentials in two ways:
Method 1: Environment Variables
- Copy the environment template:
- Configure your microCMS credentials in
.env
:
Method 2: Command Line Arguments
Pass credentials directly as command line arguments:
Note: Command line arguments take precedence over environment variables.
Usage
Running the Server
Using environment variables:
Using command line arguments:
Using with Claude Desktop
Add the following to your Claude Desktop MCP configuration file:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%/Claude/claude_desktop_config.json
Option 1: Using npx (Recommended)
Option 2: Using global installation
Option 3: Using local development setup
Replace:
your-service-id
with your microCMS service IDyour-api-key
with your microCMS API key/path/to/microcms-mcp-server/
with the actual path (Option 3 only)
Restart Claude Desktop after updating the configuration.
Development Mode
Available Scripts
npm run build
- Build TypeScript to JavaScriptnpm start
- Run the compiled servernpm run dev
- Development mode with auto-reloadnpm run lint
- Run ESLintnpm run format
- Format code with Prettier
Tool Examples
Get Content List
Get Individual Content
Create New Content
Update Content with Image
Get Media Files
Upload Media File (Base64)
Upload Media File (External URL)
Field Type Specifications
When creating or updating content, different field types require specific formats:
Text Fields
Rich Editor Fields
Image Fields
Must use URLs from the same microCMS service:
Multiple Image Fields
Date Fields
Use ISO 8601 format:
Select Fields
Content Reference Fields
Single reference:
Multiple references:
Complete Example
Media Management
Media Retrieval (microcms_get_media
)
- API Type: Management API v2 (direct fetch)
- Permissions: Requires "media retrieval" permissions
- Features:
- Pagination with tokens (15-second validity)
- Filter by filename
- Image-only filtering
- Returns URLs, dimensions, and metadata
Media Upload (microcms_upload_media
)
- API Type: Management API v1 (via JS SDK)
- Permissions: Requires "media upload" permissions
- Upload Methods:
- File Data Upload: Base64 encoded file data with filename and mimeType
- External URL Upload: Direct upload from external URL
- Limitations:
- File size: 5MB maximum
- One file per request
- Available on Team, Business, Advanced, Enterprise plans
- Returns: microCMS asset URLs
- Images:
https://images.microcms-assets.io/...
- Files:
https://files.microcms-assets.io/...
- Images:
API Reference
All tools support the full range of microCMS API parameters. Content tools use the Content API, while media tools use the Management API.
Error Handling
The server provides detailed error messages for:
- Missing required environment variables
- Invalid API requests
- microCMS API errors
- Malformed tool parameters
License
MIT
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
A Model Context Protocol server that enables AI assistants like Claude to interact with microCMS content management system through six core tools for performing CRUD operations on microCMS list-type APIs.
Related MCP Servers
- -securityFlicense-qualityA comprehensive suite of Model Context Protocol servers designed to extend AI agent Claude's capabilities with integrations for knowledge management, reasoning, advanced search, news access, and workspace tools.Last updated -5TypeScript
- -securityFlicense-qualityA Model Context Protocol server that enables AI assistants like Claude to perform Python development tasks through file operations, code analysis, project management, and safe code execution.Last updated -1Python
- -securityAlicense-qualityA Model Context Protocol server that connects Claude and other MCP clients to Aider, enabling AI assistants to efficiently edit files, create new files, and interact with git repositories through natural language.Last updated -9PythonThe Unlicense
- -securityAlicense-qualityA Model Context Protocol server that enables AI assistants like Claude to interact directly with Home Assistant, allowing them to query device states, control smart home entities, and perform automation tasks.Last updated -15PythonMIT License