Hashnode MCP Server
@sbmagar13
A Model Context Protocol (MCP) server that connects AI assistants to the Hashnode API, enabling seamless content creation, management, and retrieval through AI interactions. Create, update, and search Hashnode articles directly through Claude or other AI assistants.
Overview
What is Hashnode MCP Server?
A Model Context Protocol (MCP) server that provides tools for accessing and searching Hashnode content programmatically. It enables AI assistants to create, update, and retrieve Hashnode articles, search for content, and get user information via the Hashnode GraphQL API.
How to use Hashnode MCP Server?
Install by cloning the repository, creating a Python virtual environment, and installing dependencies. Set environment variables HASHNODE_PERSONAL_ACCESS_TOKEN and (optionally) HASHNODE_API_URL in a .env file. Run the server manually with python run_server.py or python mcp_server.py, or configure it in Claude Desktop or Cline VSCode extension to be managed automatically.
Key features of Hashnode MCP Server
- Creates and publishes new articles on Hashnode
- Updates existing articles
- Searches for articles by keywords
- Retrieves article details by ID
- Gets user information by username
- Fetches the latest articles from a publication
Use cases of Hashnode MCP Server
- Publishing articles to Hashnode directly from an AI assistant
- Updating existing Hashnode content without using the web interface
- Searching Hashnode for relevant articles on a topic
- Fetching a publication’s latest articles for analysis or aggregation
- Retrieving details about a specific article or user
FAQ from Hashnode MCP Server
What does the Hashnode MCP Server do?
It acts as a bridge between AI assistants (like Claude) that support the Model Context Protocol and the Hashnode API, allowing programmatic article management, searching, and user info retrieval.
What dependencies or runtime are required?
Python 3 with asyncio and httpx libraries, plus the packages listed in requirements.txt. The server uses asynchronous programming for efficient API communication.
How do I authenticate with the Hashnode API?
You must provide a HASHNODE_PERSONAL_ACCESS_TOKEN in the .env file or as an environment variable. The server uses this token to call the Hashnode GraphQL API at https://gql.hashnode.com.
What transport protocol does the server use?
By default, the server listens on localhost:8000 using Server-Sent Events (SSE) transport. It can also be integrated with MCP clients like Claude Desktop or Cline VSCode extension.
Can I run the server manually without Claude Desktop?
Yes. You can start it directly with python mcp_server.py or python run_server.py. The server will then accept connections from any MCP-compatible client.
