Micro.blog Books MCP Server

An MCP (Model Context Protocol) server built with FastMCP that provides access to the Micro.blog Books API. Deployed on fastmcp.cloud for easy integration with Claude Desktop and other MCP clients.

Features

This MCP server provides the following tools for managing your Micro.blog books:

Bookshelf Management

• get_bookshelves: Get all your bookshelves
• get_bookshelf_books: Get books in a specific bookshelf
• add_bookshelf: Create a new bookshelf
• rename_bookshelf: Rename an existing bookshelf

Book Management

• add_book: Add a new book to a bookshelf
• move_book: Move a book between bookshelves
• remove_book: Remove a book from a bookshelf
• change_book_cover: Update a book's cover image

Reading Goals

• get_reading_goals: Get your reading goals
• get_goal_progress: Get progress toward a specific reading goal
• update_reading_goal: Update a reading goal's target or progress

Deployment

This server is designed to be deployed on fastmcp.cloud.

Prerequisites

• A Micro.blog account with API access
• A bearer token from your Micro.blog account settings

Environment Variables

Set the following environment variable in your fastmcp.cloud deployment:

Deploy to fastmcp.cloud

1. Connect your GitHub repository to fastmcp.cloud
2. Set the MICRO_BLOG_BEARER_TOKEN environment variable in the fastmcp.cloud dashboard
3. Deploy - the server will be available at your fastmcp.cloud endpoint

Local Development

For local testing:

# Install dependencies
uv sync

# Run the server locally
export MICRO_BLOG_BEARER_TOKEN="your_token_here"
uv run fastmcp run server.py --transport http --port 8000

# Or run directly
uv run python server.py

Usage

Once deployed, you can connect to the server from Claude Desktop or any MCP client using the HTTP transport.

Example prompts:

• "Show me all my bookshelves"
• "Add 'Project Hail Mary' by Andy Weir to my Currently Reading bookshelf"
• "What are my reading goals for this year?"
• "Move book ID 79 to bookshelf ID 23"

API Reference

All tools return JSON responses from the Micro.blog API. The server handles authentication automatically using your bearer token.

For more details about the underlying API, see the Micro.blog Books API documentation.

License

This project is licensed under the MIT License - see the LICENSE file for details.