ganyariya/misskey-mcp-server
3.1
If you are the rightful owner of misskey-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
misskey-mcp-server is an unofficial MCP server for Misskey, focusing on posting notes.
misskey-mcp-server
misskey-mcp-server is an unofficial MCP (Model Context Protocol) server for Misskey.
Currently, it only has the bare minimum functionality: posting notes.
So, I would appreciate contributions (PRs) from everyone!
Features
MCP Tools Implementation Status
| MCP Tool Name | Misskey API Endpoint | Status |
|---|---|---|
| post_misskey_note | /notes/create | ✅ |
| get_misskey_note | /notes/show | ❌ |
| get_misskey_timeline | /notes/timeline | ❌ |
| get_misskey_user | /users/show | ❌ |
| get_misskey_user_notes | /users/notes | ✅ |
| get_misskey_user_following | /users/following | ❌ |
| get_misskey_user_followers | /users/followers | ❌ |
| get_misskey_notifications | /i/notifications | ❌ |
| get_misskey_mentions | /notes/mentions | ❌ |
| get_misskey_antenna | /antennas/show | ❌ |
| get_misskey_antenna_notes | /antennas/notes | ❌ |
| get_misskey_channel | /channels/show | ❌ |
| get_misskey_channel_notes | /channels/notes | ❌ |
| get_misskey_gallery | /gallery/posts/show | ❌ |
| get_misskey_gallery_posts | /gallery/posts | ❌ |
| get_misskey_page | /pages/show | ❌ |
| get_misskey_drive_files | /drive/files | ❌ |
| post_misskey_reaction | /notes/reactions/create | ❌ |
| delete_misskey_reaction | /notes/reactions/delete | ❌ |
| post_misskey_follow | /following/create | ❌ |
| delete_misskey_follow | /following/delete | ❌ |
| post_misskey_renote | /notes/create (renote) | ❌ |
| post_misskey_reply | /notes/create (reply) | ❌ |
| get_misskey_search | /notes/search | ❌ |
| get_misskey_search_by_tag | /notes/search-by-tag | ❌ |
| get_misskey_hashtags | /hashtags/trend | ❌ |
| get_misskey_emoji | /emojis | ❌ |
| get_misskey_meta | /meta | ❌ |
| get_misskey_instance | /federation/instances | ❌ |
| get_misskey_stats | /stats | ❌ |
Usage
Install
From go install
GOBIN="$HOME/go/bin" go install github.com/ganyariya/misskey-mcp-server/cmd/misskey-mcp-server@latest
Build your own
git clone https://github.com/ganyariya/misskey-mcp-server
cd misskey-mcp-server
go build -o misskey-mcp-server cmd/misskey-mcp-server/main.go
Setup
Setup your mcp.json as below.
{
"mcpServers": {
"misskey-mcp-server": {
"command": "misskey-mcp-server",
"args": [],
"env": {
// https://misskey-hub.net/ja/docs/for-developers/api/token/
"MISSKEY_API_TOKEN": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
// http or https
"MISSKEY_PROTOCOL": "https",
// your misskey server's domain
"MISSKEY_DOMAIN": "misskey.io",
"MISSKEY_PATH": ""
},
"disabled": false,
"autoApprove": []
}
}
}
Thanks to reference
- MCP Go Implementation
- MCP Server References
- Misskey Go API SDK
get_misskey_user_notes
Retrieves notes for a specific Misskey user.
Arguments:
userId(string, required): The ID of the user whose notes you want to retrieve.
Example Request:
{
"userId": "some_user_id"
}
