Ghost MCP server
README.md
# Ghost MCP server for ChatGPT and Claude
Connect ChatGPT, Claude and other AI agents to Ghost through Cotlet.dev. The live integration page describes 14 hosted operations for posts, members, newsletters and tiers. Ghost has its own Admin API; the Cotlet.dev page reports no official Ghost MCP server, checked 17 October 2026.
## What you can ask
> List my draft posts.
> Summarize newsletter performance for a post.
> Find members with low email open rates.
> Draft an issue from my notes.
> Prepare a newsletter schedule for my approval.
## Connect Ghost
Sign up at https://cotlet.dev/signup?app=ghost, enable Ghost and sign in at your own Ghost Admin domain in your Cloud Browser. Get your API key at https://cotlet.dev/app and export it as `COTLET_API_KEY`.
### ChatGPT
Settings → Apps → add connector URL `https://cotlet.dev/mcp/v1/connect`, then sign in with Cotlet.dev. No API key needed.
### Claude Code
```bash
claude mcp add --transport http cotlet https://cotlet.dev/mcp/v1 --header "Authorization: Bearer $COTLET_API_KEY"
```
### Cursor
Copy `.cursor/mcp.json` from this repo into your project:
```json
{
"mcpServers": {
"cotlet": {
"url": "https://cotlet.dev/mcp/v1",
"headers": {
"Authorization": "Bearer ${COTLET_API_KEY}"
}
}
}
}
```
## Run the local MCP bridge
Python 3.10+, with no dependencies. Clone this repository, set your Cotlet.dev API key, then run:
```bash
export COTLET_API_KEY="your-key"
python3 ghost_agent.py serve
```
This local stdio bridge lists seven browser helper tools: `ghost_guide`, `ghost_status`, `ghost_open`, `ghost_read`, `ghost_click`, `ghost_type` and `ghost_close`.
It forwards calls to the hosted Cotlet.dev MCP server.
The 14 task tools described on the integration page are available through the hosted connection.
Without a key, the local bridge can list its helpers; calls return setup instructions.
```bash
python3 ghost_agent.py connect
python3 ghost_agent.py guide
python3 ghost_agent.py status
```
## Questions from Ghost users
**Does Ghost have an API or official MCP server?**
Ghost has a REST Admin API for posts, pages, members, labels, newsletters, tiers and offers. The Cotlet.dev page reports no official Ghost MCP server, checked 17 October 2026. Use the official API when its documented endpoints cover your task.
**How do I connect Ghost to ChatGPT or Claude?**
Sign up at https://cotlet.dev/signup?app=ghost, enable Ghost and sign in to your own Ghost Admin domain in the Cloud Browser. Add https://cotlet.dev/mcp/v1/connect as a connector and sign in to Cotlet.dev.
**Which actions ask for approval?**
The live page says update_post, schedule_post, publish_post and unsubscribe_members ask for confirmation by default. Access follows your Ghost staff role. Review recipients, content and schedule before approving.
**Is this an official Ghost integration?**
No. Cotlet.dev is independent and is not affiliated with Ghost.
## Integration details
[Ghost tools and setup on Cotlet.dev](https://cotlet.dev/integrations/ghost-api-mcp-server?utm_source=github&utm_medium=readme&utm_campaign=ghost)
---
More: https://cotlet.dev/integrations/ghost-api-mcp-server?utm_source=github&utm_medium=readme&utm_campaign=ghost
Start free: https://cotlet.dev/signup?app=ghost&utm_source=github&utm_medium=readme&utm_campaign=ghost