Sunsama

No installation required! Use directly with:

git clone https://github.com/robertn702/mcp-sunsama.git cd mcp-sunsama

cp .env.example .env # Edit .env and add your Sunsama credentials

- SUNSAMA_EMAIL- Your Sunsama account email (required for stdio transport)
- SUNSAMA_PASSWORD- Your Sunsama account password (required for stdio transport)
- TRANSPORT_MODE- Transport type:stdio(default) orhttp
- PORT- Server port for HTTP transport (default: 8080)
- HTTP_ENDPOINT- MCP endpoint path (default:/mcp)
- SESSION_TTL- Session timeout in milliseconds (default: 3600000 / 1 hour)
- CLIENT_IDLE_TIMEOUT- Client idle timeout in milliseconds (default: 900000 / 15 minutes)
- MAX_SESSIONS- Maximum concurrent sessions for HTTP transport (default: 100)

This server supports two transport modes:

For local AI assistants (Claude Desktop, Cursor, etc.):

bun run dev # or TRANSPORT_MODE=stdio bun run src/main.ts

For remote access and web-based integrations:

TRANSPORT_MODE=http PORT=8080 bun run src/main.ts

- MCP Endpoint:POST http://localhost:8080/mcp
- Health Check:GET http://localhost:8080/

Authentication:HTTP requests require HTTP Basic Auth with your Sunsama credentials:

curl -X POST http://localhost:8080/mcp \ -H "Authorization: Basic $(echo -n 'your-email:your-password' | base64)" \ -H "Content-Type: application/json" \ -d '{"jsonrpc":"2.0","method":"tools/list","id":1}'

Add this configuration to your Claude Desktop MCP settings:

The server is organized with a modular, resource-based architecture:

src/ ├── tools/ │ ├── shared.ts # Common utilities and patterns │ ├── user-tools.ts # User operations (get-user) │ ├── task-tools.ts # Task operations (15 tools) │ ├── stream-tools.ts # Stream operations (get-streams) │ └── index.ts # Export all tools ├── resources/ │ └── index.ts # API documentation resource ├── auth/ # Authentication strategies │ ├── stdio.ts # Stdio transport authentication │ ├── http.ts # HTTP Basic Auth parsing │ └── types.ts # Shared auth types ├── transports/ │ ├── stdio.ts # Stdio transport implementation │ └── http.ts # HTTP Stream transport with session management ├── session/ │ └── session-manager.ts # Session lifecycle management ├── config/ # Environment configuration │ ├── transport.ts # Transport mode configuration │ └── session-config.ts # Session TTL configuration ├── utils/ # Utilities (filtering, trimming, etc.) │ ├── client-resolver.ts # Transport-agnostic client resolution │ ├── task-filters.ts # Task completion filtering │ ├── task-trimmer.ts # Response size optimization │ └── to-tsv.ts # TSV formatting utilities ├── schemas.ts # Zod validation schemas └── main.ts # Server setup (47 lines vs 1162 before refactoring) __tests__/ ├── unit/ # Unit tests (no auth required) │ ├── auth/ # Auth utility tests │ ├── config/ # Configuration tests │ └── session/ # Session management tests └── integration/ # Integration tests (requires credentials) └── http-transport.test.ts

- Type Safety: Full TypeScript typing with Zod schema validation
- Parameter Destructuring: Clean, explicit function signatures
- Shared Utilities: Common patterns extracted to reduce duplication
- Error Handling: Standardized error handling across all tools
- Response Optimization: Task filtering and trimming for large datasets
- Session Management: Dual-layer caching with TTL-based lifecycle management
- Test Coverage: 251+ unit tests and comprehensive integration tests

Stdio Transport:RequiresSUNSAMA_EMAILandSUNSAMA_PASSWORDenvironment variables.

HTTP Transport:Credentials provided via HTTP Basic Auth per request. No environment variables needed for credentials.

- Development workflow
- Code style and conventions
- Testing requirements
- Release process (for maintainers)
- Fork and clone the repository
- Install dependencies:bun install
- Make your changes
- Create a changeset:bun run changeset
- Submit a pull request

The 1Password MCP server creates a bridge that allows MCP clients such as Codex and Kiro to manage your 1Password Environments with secure authorization prompts.

This is the 1st, easiest, and cheapest PPT, slides, presentation AI generation MCP Server in the world.

Persistent memory for any AI assistant. Zero token cost until recall. Stores memories in local SQLite, ranks by 6-factor scoring, returns results 79% smaller than JSON. Works with Claude, ChatGPT, Grok, Cursor, Windsurf, and any MCP client.

A MCP server that enables AI assistants to interact with Anki, the spaced repetition flashcard application.

Enables LLM clients to interact with macOS applications through AppleScript. Built using the @beyondbetter/bb-mcp-server library, this server provides safe, controlled execution of predefined scripts with optional support for arbitrary script execution.

An MCP server for WordPress plugin audits

Turn your AI assistant into a digital marketing hub that creates, organizes, and analyzes links and QR Codes on demand.

Connect AI clients to Cal.com scheduling through the Model Context Protocol using the hosted server at mcp.cal.com or a local instance.