Fastidious MCP Server

MCP (Model Context Protocol) server for Fastidious AI notes application.

Deployment

Environment Variables

Variable	Description	Default
FASTIDIOUS_URL	Fastidious API base URL	http://localhost:3000

Deploy to Coolify

1. Create a new service in Coolify
2. Connect to this repository
3. Set build pack to Nixpacks or Dockerfile
4. Configure environment variable:

   FASTIDIOUS_URL=https://blog.tjb.app
   

   Or for internal Docker network: FASTIDIOUS_URL=http://fastidious:3000
5. Set the domain to mcp.tjb.app
6. Deploy

Docker

docker build -t fastidious-mcp .
docker run -p 3001:3001 -e FASTIDIOUS_URL=https://blog.tjb.app fastidious-mcp

Usage

Claude Desktop Configuration

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "fastidious": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.tjb.app/sse?token=YOUR_TOKEN_HERE"]
    }
  }
}

Get your token from Fastidious AI Settings (sidebar → profile → Settings).

Note: Uses mcp-remote to proxy the remote SSE connection.

Local Development (stdio mode)

For local testing with Claude Desktop:

{
  "mcpServers": {
    "fastidious": {
      "command": "npx",
      "args": ["tsx", "/path/to/mcp-server/src/index.ts"],
      "env": {
        "FASTIDIOUS_TOKEN": "YOUR_TOKEN_HERE",
        "FASTIDIOUS_URL": "https://blog.tjb.app"
      }
    }
  }
}

Available Tools

Tool	Description
create_note	Create a new markdown note
get_note	Get a note by ID
update_note	Update a note
delete_note	Delete a note
list_notes	List all notes (with optional collection filter)
search_notes	Search notes by content
create_collection	Create a new collection
get_collection	Get a collection (with optional contents)
list_collections	List all collections
add_to_collection	Add notes to a collection
remove_from_collection	Remove notes from a collection

Architecture

Claude Desktop
    ↓ MCP Protocol (SSE)
MCP HTTP Server (mcp.tjb.app)
    ↓ HTTP + Bearer Token
Fastidious API (blog.tjb.app/api/mcp/*)
    ↓
User's Notes & Collections

API Endpoints

• GET /health - Health check
• GET /sse?token=TOKEN - MCP SSE endpoint for Claude Desktop

Internal Network (Docker/Coolify)

If running alongside Fastidious in the same Docker network:

FASTIDIOUS_URL=http://fastidious:3000

This avoids external network hops for better performance.